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Emitter Framework 



Chapter 1. Emitter Framework 

The entry classes are arranged into the class hierarchy shown below. 







inherils from 



Figure 1. Entry Class Hierarchy 



Chapter 1 . Emitter Framework 1 



SOMTAttributeEntryC Class 



SOMTAttributeEntryC Class 

A SOMTAttributeEntryC object represents an attribute declaration statement in a class 
interface definition. It provides attributes for accessing the type of the attribute and whether 
it is readonly, and methods for accessing the names of the attributes being declared and 
their get and set methods. 



File Stem 

scattrib 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass Class 

Ancestor Classes 

SOMTEntryC Class 
SOMObject Class 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtlsReadonly 

(boolean) Whether the attribute is defined as readonly. This attribute has no set 
method. 

somtAttribType 

(SOMTEntryC A pointer to an entry object representing the base type of the attribute. 
This does not include pointer stars or array declarators; to get the full type, get each 
attribute declarator in turn and get its somtType attribute. This attribute has no set 
method. 



New Methods 

somtGetFirst<ltem> Methods 

somtGetFirstAttributeDeclarator 
somtGetFirstGetMethod 
somtGetFirstsetMethod 
somtGetNext<ltem> Methods 

somtGetNextAttributeDeclarator 

somtGetNextGetMethod 

somtGetNextsetMethod 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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somtGetFirst<ltem> Methods 



somtGetFirst<ltem> Methods 

These methods get the first declarator, get method, or set method for an attribute entry. 



IDL Syntax 

SOMTDataEntryC somtGetFirstAttributeDeclarator ( ); 

SOMTMethodEntryC somtGetFirstGetMethod ( ); 

SOMTMethodEntryC somtGetFirstsetMethod ( ); 

Note: These methods do not take an Environment parameter. 

Description 

The somtGetFirst<ltem> methods return the first item of the type shown above for the 
entry specified by receiver. The next item of the same kind can be obtained using the 
corresponding somtGetNext<ltem> method. For example, the 
somtGetFirstAttributeDeclarator method returns the entry representing the first 
declarator of the specified attribute entry. The somtGetNextAttributeDeclarator can be 
used repeatedly to retrieve each successive declarator. 

The same somtGetFirst<ltem> and somtGetNext<ltem> methods cannot be used in 
doubly nested loops. For example, the following doubly nested loop will not work, because 
after the first execution of the inner loop, the invocation of 
somtGetNextAttributeDeclarator in the outer loop will return NULL: 

for (dl = _somtGetFirstAttributeDeclarator (attrib) ; dl ; 
dl = _somtGetNextAttributeDeclarator (attrib) ) 
for (d2 = _somtGetFirstAttributeDeclarator (attrib) ; d2 ; 
d2 = _somtGetNextAttributeDeclarator (attrib) ) 

/* etc. */ 

Nested loops such as the one above are permissible if the target object (for example, 
“attrib”) of the inner loop differs from the target object of the outer loop, or if a different 
somtGetFirst <ltem> method is used in the inner loop (for instance, you can nest a 

somtGetNextGetMethod loop inside a somtGetNextAttributeDeclarator loop). 

Parameters 

receiver 

The entry whose first item is to be retrieved. 



Return Value 

These methods return the first declarator, get method, or set method for an attribute entry. 



Example 

To iterate through the declarators of an attribute statement: 

SOMTDataEntryC myEntry; 

SOMTAttributeClassEntryC attrib; 

printf ( "List of declarators : \n" ) ; 

for (myEntry = _somtGetFirstAttributeDeclarator (attrib) ; 
myEntry; 

myEntry = _somtGetNextAttributeDeclarator (attrib) ) 
printf ("%s\n" , get_somtEntryName (myEntry) ) ; 

Related Information 

somtGetNext<ltem> Methods 
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somtGetNext<ltem> Methods 



somtGetNext<ltem> Methods 

These methods get the next declarator, get method, or set method for an attribute entry, 
relative to the previous call for a similar entry. 

IDL Syntax 

SOMTDataEntryC somtGetNextAttributeDeclarator ( ); 

SOMTMethodEntryC somtGetNextGetMethod ( ); 

SOMTMethodEntryC somtGetNextsetMethod ( ); 

Note: These methods do not take an Environment parameter. 

Description 

The somtGetNext<ltem> methods return the next declarator, get method, or set method 
for the entry represented by receiver, if it has a next item of that type. Otherwise, it returns 
NULL. 

A call to a somtGetNext<ltem> method is relative to the last call of either the same method 
or the corresponding somtGetFirst<ltem> method applied to the same entry object. 

This implies that the same somtGetFirst<ltem> and somtGetNext<ltem> methods cannot 
be used in doubly nested loops. For example, the following doubly nested loop will not 
work, because following the first execution of the inner loop, the invocation of 

somtGetNextAttributeDeclarator in the outer loop will return NULL: 

for (dl = _somtGetFirstAttributeDeclarator (attrib) ; dl ; 
dl = _somtGetNextAttributeDeclarator (attrib) ) 
for (d2 = _somtGetFirstAttributeDeclarator (attrib) ; d2 ; 
d2 = _somtGetNextAttributeDeclarator (attrib) ) 

/* etc. */ 

Nested loops such as the one above are permissible if the target object of the inner loop 
differs from the target object of the outer loop, or if a different somtGetFirst<ltem> method 
is used in the inner loop. 

Parameters 

receiver 

The entry whose next item is to be retrieved. 



Return Value 

These methods return the next item for the entry represented by receiver, if it has a next 
item. Otherwise, it returns NULL. The type of item returned is specific to the method. 



Example 

To iterate through the declarators of an attribute statement: 

SOMTDataEntryC myEntry; 

SOMTAttributeClassEntryC attrib ; 

printf("List of declarators : \n" ) ; 

for (myEntry = _somtGetFirstAttributeDeclarator (attrib) ; 
myEntry; 

myEntry - _somtGetNextAttributeDeclarator (attrib) ) 
printf ("%s\n" , get_somtEntryName (myEntry) ) ; 

Related Information 

somtGetFirst<ltem> Methods 
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SOMTBaseClassEntryC Class 



SOMTBaseClassEntryC Class 

A SOMTBaseClassEntryC object represents a base class declaration in a class definition. 
The entry for the base class itself is accessed via the somtBaseClassDef attribute. 

File Stem 

scbase 

Base 

SOMTEntryC Class 

MetaClass 

SOMCIass Class 

Ancestor Classes 

SOMTEntryC Class 
SOMObject Class 

Attributes 

Listed below is the available attribute, its corresponding type in parentheses and a 
description of its purpose: 

somtBaseClassDef 

(SOMTCIassEntryC) An entry object representing the definition of the base class 
named in this entry. This attribute has no set method. 

New Methods 

None 

Overriding Methods 

somDumpSelflnt Method 
somtSetSymbolsOnEntry Method 
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SOMTCIassEntryC Class 



SOMTCIassEntryC Class 

A SOMTCIassEntryC object represents a complete class interface definition. A 
SOMTCIassEntryC object provides methods for accessing the constants, types, structs, 
unions, enums, sequences, attributes, and methods defined within an interface statement, 
It also provides methods for accessing the instance data, passthrus, and release names 
defined in the SOM IDL implementation section of the interface statement. 

A number of the possible statements in an IDL definition are optional. When they are 
missing from the class definition, then methods that would return an entry for that kind of 
statement will return NULL. 



File Stem 

scclass 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass Class 

Ancestor Classes 

SOMTEntryC Class 
SOMObject Class 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtSourceFileName 

(string) The name of the file containing the class definition. This attribute has no set 
method. 

somtMetaClassEntry 

(SOMTMetaClassEntryC) A pointer to an entry object representing the metaclass 
statement in a class definition, or NULL if there is none explicitly specified. This attribute 
has no set method. 

somtClassModule 

(SOMTModuleEntryC) The module enclosing this class, or NULL if there is not one. 

somtNewMethodCount 

(long) The number of methods the class introduces. This attribute has no set method. 

somtStaticMethodCount 

(long) The number of static methods the class introduces. This attribute has no set 
method. 

somtOverrideMethodCount 

(long) The number of methods the class overrides. This attribute has no set method. 

somtProcMethodCount 

(long) The number of procedure methods the class implements. This attribute has no 
set method. 

somtVAMethodCount 

(long) The number of methods in the class that take a variable number of arguments. 
This attribute has no set method. 
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SOMTCIassEntryC Class 



somtBaseCount 

(int) The number of base classes for the class. This attribute has no set method. 

somtMetaclassFor 

(SOMTCIassEntryC) If the class is a metaclass, a pointer to an entry object 
representing a class for which it is a metaclass. This attribute has no set method. 

somtForwardRef 

(boolean) Whether or not this entry represents a forward reference. This attribute has 
no set method. 



New Methods 

The SOMTCIassEntryC class introduces new methods from groups scanners and filters. 

Group: scanners 

somtGetFirst<ltem> Methods 
somtGetFirstBaseClass 
somtGetFirstReleaseName 
somtGetFirstPassthru 
somtGetFirstData 
somtGetFirstMethod 
somtGetFirstlnherited Method 
somtGetFirstAttribute 
somtGetFirstConstant 
somtGetFirstStruct 
somtGetFirstUnion 
somtGetFirstEnum 
somtGetFirstTypedef 
somtGetFirstSequence 
somtGetFirstPubdef 

somtGetNext<ltem> Methods 
somtGetNextBaseClass 
somtGetNextReleaseName 
somtGetNextPassthru 
somtGetNextData 
somtGetNextMethod 
somtGetNextln herited Method 
somtGetNextAttribute 
somtGetNextConstant 
somtGetNextStruct 
somtGetNextUnion 
somtGetNextEnum 
somtGetNextTypedef 
somtGetNextSequence 
somtGetNextPubdef 

somtGetReleaseNameList Method 

Group: filters 

somtFilterNew Method 
somtFilterOverridden Method 

Overriding Methods 

somDumpSelflnt Method 
somtSetSymbolsOnEntry Method 
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somtFilterNew Method 



somtFilterNew Method 

Determines whether a method is introduced by a particular class. 

IDL Syntax 

boolean somtFilterNew (in SOMTMethodEntryC method); 

Note: This method does not take an Environment parameter. 

Description 

The somtFilterNew method returns TRUE if the specified method is introduced by the 
class represented by the receiver. Otherwise, it returns FALSE. 

Parameters 

receiver 

An object of class SOMTCIassEntryC representing a class. 

method 

An object of class SOMTMethodEntryC Class representing the method to be tested. 

Return Value 

The somtFilterNew method returns TRUE if the specified method is introduced by the 
class represented by the receiver. Otherwise, it returns FALSE. 



Example 

SOMTCIassEntryC els = get_somtTargetClass (emitter ) ; 

SOMTMethodEntryC method; 

method = _somtGetFirstMethod (els) ; 

if (_somtFilterNew (els , method)) 

printf ( "Method %s is introduced by %s.\n", 

get_somtEntryName (method) , 

get_somtEntryName (els) ) ; 



Original Class 

SOMTCIassEntryC 

Related Information 

somtFilterOverridden Method 
somtNew Method 
somtNewProc Method 
somtNewNoProc Method 
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somtFilterOverridden Method 



somtFilterOverridden Method 

Determines whether a method is overridden by a particular class. 



IDL Syntax 

boolean somtFilterOverridden (in SOMTMethodEntryC method ); 

Note: This method does not take an Environment parameter. 

Description 

The somtFilterOverridden determines whether a method is overridden by a particular 
class. 

Parameters 

receiver 

An object of class SOMTCIassEntryC representing a class. 

method 

An object of class SOMTMethodEntryC representing the method to be tested. 



Return Value 

The somtFilterOverridden method returns TRUE if the specified method is overridden by 
the class represented by the receiver. Otherwise, it returns FALSE. 



Example 

SOMTCIassEntryC els = get_somtTargetClass (emitter ) ; 

SOMTMethodEntryC method; 

method = _somtGetFirstMethod (els) ; 

if (_somtFilterOverridden (els , method)) 

printf ( "Method %s is an overriding method. \n" , 

get_somtEntryName (method) ) ; 



Original Class 

SOMTCIassEntryC 

Related Information 

somtFilterNew Method 
somtOverridden Method 
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somtGetFirst</tem> Methods 

These methods get the first item (such as a parent class, method, constant) for a class 
entry. 



IDL Syntax 

SOMTAttributeEntryC somtGetFirstAttribute ( ); 

SOMTBaseClassEntryC somtGetFirstBaseClass ( ); 

SOMTConstEntryC somtGetFirstConstant ( ); 

SOMTDataEntryC somtGetFirstData ( ); 

SOMTEnumEntryC somtGetFirstEnum ( ); 

SOMTMethodEntryC somtGetFirstlnheritedMethod ( ); 

SOMTMethodEntryC somtGetFirstMethod ( ); 

SOMTPassthruEntryC somtGetFirstPassthru ( ); 
string somtGetFirstReleaseName ( ); 

SOMTSequenceEntryC somtGetFirstSequence ( ); 

SOMTStructEntryC somtGetFirstStruct ( ); 

SOMTTypedefEntryC somtGetFirstTypedef ( ); 

SOMTUnionEntryC somtGetFirstUnion ( ); 

SOMTEntryC somtGetFirstPubdef ( ); 

Note: These methods do not take an Environment parameter. 

Description 

The somtGetFirst<ltem> methods return the first item of the type shown above for the 
entry specified by receiver, if it has one. Otherwise, it returns NULL. The next item of the 
same kind can be obtained using the corresponding somtGetNext<ltem> method. For 
example, the somtGetFirstMethod method returns the entry representing the first new or 
overriding method of the specified class. If the class has no new or overriding methods, it 
returns NULL. The somtGetNextMethod can be used repeatedly to retrieve each 
successive method. The somtGetFirstPubdef method returns the first constant/type 
definition of the class, whether a typedef, struct, union, etc. If the class does not explicitly 
declare a metaclass or include the IDL specification for SOMCIass, then the first pubdef 
will be an entry introducing SOMCIass as a valid type name. 

Note that the same somtGetFirst<ltem> and somtGetNext<ltem> methods cannot be 
used in doubly nested loops. For example, the following doubly nested loop will not work, 
because following the first execution of the inner loop, the invocation of 
somtGetNextMethod in the outer loop will return NULL: 

for (ml = _somtGetFirstMethod (els) ; ml; 
ml = _somtGetNextMethod (els) ) 
for (m2 = _somtGetFirstMethod (els) ; m2 ; 
m2 - _somtGetNextMethod (els) ) 

/* etc. */ 

Nested loops such as the one above are permissible if the target object of the inner loop 
differs from the target object of the outer loop, or if a different somtGetFirst<ltem> method 
is used in the inner loop. 

Parameters 

receiver 

The entry whose first item is to be retrieved. 



Return Value 

These methods return the first item (such as a parent class, method, constant) for a class 
entry. The type of item returned is specific to the method. 
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somtGetFirst<ltem> Methods 



Example 

To iterate through the base classes of a class: 

SOMTBaseClassEntryC myEntry; 
printf("List of base classes : \n" ) ; 

for (myEntry = _somtGetFirstBaseClass (els) ; myEntry; 
myEntry = _somtGetNextBaseClass (els) ) 
printf ("%s\n" , get_somtEntryName (myEntry) ) ; 



Related Information 

somtGetNext<ltem> Methods 
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somtGetNext</tem> Methods 

These methods get the next item for a class entry, relative to the previous call for a similar 
entry. 



IDL Syntax 

SOMTAttributeEntryC somtGetNextAttribute ( ); 

SOMTBaseClassEntryC somtGetNextBaseClass ( ); 

SOMTConstEntryC somtGetNextConstant ( ); 

SOMTDataEntryC somtGetNextData ( ); 

SOMTEnumEntryC somtGetNextEnum ( ); 
somtMethodEntryC somtGetNextlnheritedMethod ( ); 
somtMethodEntryC somtGetNextMethod ( ); 

SOMTPassthruEntryC somtGetNextPassthru ( ); 
string somtGetNextReleaseName ( ); 

SOMTSequenceEntryC somtGetNextSequence ( ); 

SOMTStructEntryC somtGetNextStruct ( ); 

SOMTTypedefEntryC somtGetNextTypedef ( ); 

SOMTUnionEntryC somtGetNextUnion ( ); 

SOMTEntryC somtGetNextPubdef ( ); 

Note: These methods do not take an Environment parameter. 

Description 

somtGetNext<ltem> return the next item for the entry represented by receiver, if it has a 
next item. Otherwise, it returns NULL. 

A call to a somtGetNext<ltem> method is relative to the last call of either the same method 
or the corresponding somtGetFirst<ltem> method, applied to the same entry object. This 
implies that the same somtGetFirst<ltem> and somtGetNext<ltem> methods cannot be 
used in doubly nested loops. For example, the following doubly nested loop will not work, 
because following the first execution of the inner loop, the invocation of 
somtGetNextMethod in the outer loop will return NULL: 

for (ml = _somtGetFirstMethod (els) ; ml; 
ml = _somtGetNextMethod (els) ) 
for (m2 = _somtGetFirstMethod (els) ; m2 ; 
m2 = _somtGetNextMethod (els) ) 

/* etc. */ 

Nested loops are permissible if the target object of the inner loop differs from the target 
object of the outer loop, or if a different somtGetFirst <ltem> method is used in the inner 
loop. 

Parameters 

receiver 

The entry whose next item is to be retrieved. 



Return Value 

These methods return the next item for the entry represented by receiver, if it has a next 
item. Otherwise, it returns NULL. The type of item returned is specific to the method. 

Example 

To iterate through the base classes: 

SOMTBaseClassEntryC myEntry; 
printf ( "List of base classes : \n" ) ; 

for (myEntry = _somtGetFirstBaseClass (els) ; myEntry; 
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somtGetNext<ltem> Methods 

myEntry = _somtGetNextBaseClass (els) ) 
printf ("%s\n" , get_somtEntryName (myEntry) ) ; 

Related Information 

somtGetFirst<ltem> Methods 
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somtGetReleaseNameList Method 



somtGetReleaseNameList Method 

Gets the release-order list of a class. 



IDL Syntax 

long somtGetReleaseNameList (in string buffer); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetReleaseNameList method puts the release-order list of the specified class in 
buffer. Names in the list are delimited by newlines so that the list can be used as a symbol 
value suitable for list substitution. Users must allocate enough space for the buffer; no tests 
are made to assure that adequate space has been allocated. Upon completion, 
somtGetReleaseNameList returns the number of release-order names stored in buffer. 

Parameters 

receiver 

An object of class SOMTCIassEntryC representing a class. 

buffer 

The address of a character buffer in which to store the release-order list. 



Return Value 

The somtGetReleaseNameList method returns the number of names stored in buffer. 

Original Class 

SOMTCIassEntryC Class 

Related Information 

somtGetFirstReleaseName and somtGetNextReleaseName as associated with 
somtGetFirst<ltem> Methods and somtGetNext<ltem> Methods respectively. 
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SOMTCommonEntryC Class 

The SOMTCommonEntryC class defines methods and attributes that are common to its 
subclasses: SOMTMethodEntryC Class, SOMTDataEntryC Class, 
SOMTUserDefinedTypeEntryC Class and SOMTParameterEntryC Class. Entry objects 
that an emitter uses are instances of one of these subclasses, rather than of 
SOMTCommonEntryC itself. The SOMTCommonEntryC class provides attributes and 
methods for accessing type information. 



File Stem 

sccommon 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass Class 

Ancestor Classes 

SOMTEntryC Class 
SOMObject Class 



Attributes 

Below is each available attribute, its corresponding type in parentheses, and its purpose. 

somtTypeObj 

(SOMTEntryC) A pointer to the object representing the type of the entry. This attribute 
may be NULL when processing an input file containing an OIDL, rather than an IDL, 
interface specification. This attribute has no set method. 

somtType 

(string) The IDL type of the entry, in string form. For methods, this is the return type; for 
data, parameters, or user-defined types, it is the type. It is in the form 
<typename><pointer stars> <array- declarators. This attribute has no set method. 

somtPtrs 

(string) The string of stars associated with a pointer type. For example, a type “short *” 
has somtPtrs = a type “short **” has somtPtrs = and so forth. If the type of 
the entry is not a pointer, then somtPtrs = null. This attribute may be NULL when 
processing an input file containing an OIDL, rather than an IDL, interface specification. 
This attribute has no set method. 

somtArrayDimsString 

(string) The array dimensions, as a string, for entries of array type. There is no set 
method. 



New Methods 

somtlsArray Method 
somtlsPointer Method 
somtGetFirstArrayDimension Method 
somtGetNextArrayDimension Method 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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somtGetFirstArrayDimension Method 

The somtGetFirstArrayDimension method gets the first array dimension for 
particular entry. 



IDL Syntax 

unsigned long somtGetFirstArrayDimension ( ); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetFirstArrayDimension method returns the first array dimension for the entry 
on which the method is invoked, if it has one. Otherwise, it returns zero. The next array 
dimension can be obtained using the corresponding somtGetNextArrayDimension 
method. 

The somtGetFirstArrayDimension and somtGetNextArrayDimension methods cannot 
be used in doubly nested loops. For example, the following doubly nested loop will not 
work, because following the first execution of the inner loop, the invocation of 
somtGetNextArrayDimension in the outer loop will return zero: 

for (adl = _somtGetFirstArrayDimension (entry) ; adl; 
adl = —SomtGetNextArrayDimension (entry) ) 
for (ad2 = —SomtGetFirstArrayDimension (entry) ; ad2 ; 
ad2 = —SomtGetNextArrayDimension (entry) ) 

/* etc. */ 

Nested loops such as the one above are permissible if the target object of the inner loop 
differs from the target object of the outer loop, or if a different somtGetFirst<ltem> 
Methods is used in the inner loop. 

The somtGetFirstArrayDimension method may not be reliable when processing an OIDL, 
rather than an IDL, interface specification. 

Parameters 

receiver 

The entry whose first array dimension is to be retrieved. 



Return Value 

The somtGetFirstArrayDimension method returns the first array dimension for a 
particular entry, if it has one; otherwise, it returns zero. 



Example 

To iterate through the array dimensions of a method: 

unsigned long n; 

printf ("List of array dimensions : \n" ) ; 
for (n = —SomtGetFirstArrayDimension (method) ; n; 
n = —SomtGetNextArrayDimension (method) ) 
printf ( " [%lu] " , n) ; 

Related Information 

somtGetNextArrayDimension Method 
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somtGetNextArrayDimension Method 

Gets the next array dimension for a particular entry, relative to the previous call for a similar 
entry. 



IDL Syntax 

unsigned long somtGetNextArrayDimension ( ); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetNextArrayDimension method returns the next array dimension for the entry 
represented by receiver, if it has a next dimension. Otherwise, it returns zero. 

A call to a somtGetNextArrayDimension method is relative to the last call of either the 
same method or the corresponding somtGetFirstArrayDimension method, applied to the 
same entry object. This implies that the same somtGetFirstArrayDimension and 
somtGetNextArrayDimension methods cannot be used in doubly nested loops. For 
example, the following doubly nested loop will not work, because following the first 
execution of the inner loop, the invocation of somtGetNextArrayDimension in the outer 
loop will return zero: 

for (adl = _somtGetFirstArrayDimension (entry) ; adl; 
adl = —SomtGetNextArrayDimension (entry) ) 
for (ad2 = —SomtGetFirstArrayDimension (entry) ; ad2 ; 
ad2 = —SomtGetNextArrayDimension (entry) ) 

/* etc. */ 

Nested loops such as the one above are permissible if the target object of the inner loop 
differs from the target object of the outer loop, or if a different somtGetFirst<ltem> 
Methods is used in the inner loop. 

Parameters 

receiver 

The entry whose next array dimension is to be retrieved. 



Return Value 

The somtGetNextArrayDimension method returns the next array dimension for the 
specified entry, if it has a next dimension. Otherwise, it returns zero. 



Example 

To iterate through the array dimensions of a method: 

unsigned long n; 

printf ("List of array dimensions : \n" ) ; 
for (n = —SomtGetFirstArrayDimension (method) ; n; 
n = —SomtGetNextArrayDimension (method) ) 
printf (" [%lu] " , n) ; 

Related Information 

somtGetFirstArrayDimension Method 
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somtlsArray Method 

Tests to determine whether the type of a method, data item, user-defined type, attribute 
declarator, struct member declarator, or parameter is an array. If so, its size is returned. 



IDL Syntax 

boolean somtlsArray (out long *size); 

Note: This method does not take an Environment parameter. 

Description 

The somtlsArray method has a dual purpose. If the type of the receiver involves an array, 
then somtlsArray returns TRUE and sets size to the size (in the first dimension) of the 
array encountered. If no array is encountered, then somtlsArray returns FALSE. 

Parameters 

receiver 

An object of class SOMTCommonEntryC representing a method, data item, 
user-defined type, declarator, or parameter to test. 

size 

The address where the size of the array should be stored. 

Return Value 

If the specified entry’s type is an array, then the somtlsArray method returns TRUE and 
size is set to the size (in the first dimension) of the array. Otherwise, somtlsArray returns 
FALSE. 

Original Class 

SOMTCommonEntryC 

Related Information 

somtlsPointer Method 
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somtlsPointer Method 

Tests whether the type of a method, data item, user-defined type, attribute declarator, struct 
member declarator or parameter is a pointer. 

IDL Syntax 

boolean somtlsPointer ( ); 

Note: This method does not take an Environment parameter. 

Description 

The somtlsPointer method returns TRUE if the type of the SOMTCommonEntryC object 
is a pointer. Otherwise, it returns FALSE. 

Parameters 

receiver 

An object of class SOMTCommonEntryC representing the entry to be tested. 

Return Value 

The somtlsPointer method returns TRUE if the type of the SOMTCommonEntryC object 
is a pointer. Otherwise, it returns FALSE. 



Example 

SOMTCommonEntryC myEntry; 

if ( somtlsPointer (myEntry) 

printf("Saw a pointer . \n" ) ; 
boolean somtlsArray ( 

out long *size);else 
printf ("Dicin' t see a pointer ! \n" ) ; 



Original Class 

SOMTCommonEntryC 

Related Information 

somtlsArray Method 
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SOMTConstEntryC Class 

A SOMTConstEntryC object represents a constant definition. It provides attributes for 
accessing the type and value of the constant. 



File Stem 

scconst 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMTEntryC Class 
SOMObject 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtConstTypeObj 

(SOMTEntryC) A pointer to an object representing the type of the constant’s value. 
This attribute has no set method. 

somtConstType 

(string) The type of the constant’s value, as a string. This attribute has no set method. 

somtConstStringVal 

(string) The (unevaluated) value of the constant, as a string. The value of constants of 
type string or char do not include the quotes, unlike the somtConstVal attribute. This 
attribute has no set method. 

somtConstVal 

(string) The evaluated value of the constant, as a string. This attribute has no set 
method. The get method return a string whose ownership is transferred to the caller. 

somtConstlsNegative 

(boolean) Whether the constant’s value is a negative short or long integer. 

somtConstNumVal 

(unsigned long) The numeric value of the constant. This attribute has no set method. 
This attribute should only be used if the value of the constant can be represented by an 
unsigned long. 

somtConstNumNegVal 

(long) The numeric value of the constant, if it is a negative short or long integer. This 
attribute has no set method. This attribute should be used instead of 
somtConstNumVal if the value of the constant is negative. 



New Methods 

None. 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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SOMTDataEntryC Class 

A SOMTDataEntryC object represents either an internal instance data declaration in the 
implementation section of a SOM IDL class interface definition or a declarator of an 
attribute or struct member. 



File Stem 

scdata 

Base 

SOMTCommonEntryC Class 

Metaclass 

SOMCIass Class 

Ancestor Classes 

SOMTCommonEntryC Class 
SOMTEntryC Class 
SOMObject Class 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose. The following attributes has no set method. 

somtlsSelfRef 

(boolean) Whether a declarator of a structure member is self-referential (pointing to the 
same type of structure for which it is a member). 



New Methods 

None. 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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SOMTEmitC Class 

An object of the SOMTEmitC class represents an emitter. A new type of emitter can be 
constructed by subclassing this class and overriding the somtGenerateSections Method 
and other methods, if necessary. 

An emitter has as attributes: a target file, a target class or target module and a template. 
The target file is the file to which output will be directed. The target class or module is 
represented by an object of SOMTCIassEntryC or SOMTModuleEntryC . This object is 
constructed by the SOM Compiler when it compiles the IDL specification. The 
SOMTCIassEntryC and SOMTModuleEntryC classes provide methods for accessing 
information found in the IDL specification of the target class or module. 

The template of the emitter defines the format and content of the sections that the emitter 
produces. The emitter itself controls which sections are actually emitted and their order, by 
its implementation of the somtGenerateSections method. The template is represented by 
an object of class SOMTTemplateOutputC that is initialized from the template file (typically 
an .efw file). The template is defined in terms of symbols that, when emitted, are replaced 
by values appropriate for the emitter’s target class/module. The SOMTemplateOutputC 
class defines several general-purpose symbols as well as methods through which an 
emitter can define special-purpose symbols. An emitter’s template also maintains the 
emitter’s symbol table. 

The SOMTEmitC class provides methods for emitting sections that are common to many 
emitter templates. These methods are listed in the sections group, below. A subclass of 
SOMTEmitC can override these methods to change the way that a particular section is 
emitted. The SOMTTemplateOutputC class provides methods for defining and emitting 
special-purpose sections. 

Emitter Sections 

The SOMTEmitC class provides methods for emitting the following template sections. The 
default section name is given in parentheses. By convention, section names end in “S”. 

Prolog 

Describes text to be emitted before any other sections (prologS). 

Base Includes 

Determines how base (parent) class #include statements are emitted (baselncludesS). 
Meta Include 

Determines how a metaclass #include statement is emitted (metalncludeS). 

Class 

Determines what information about the class as a whole is emitted (classS). 

Base 

Determines what information about a base classes of a class is emitted (baseS). 

Meta 

Determines what information about the class’s metaclass is emitted (metaS). 

Constant 

Determines what information about user-defined constants is emitted (constants). 
Typedef 

Determines what information about user-defined types is emitted (typedefS). 

Struct 

Determines what information about user-defined structs is emitted (structS). 
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Union 

Determines what information about user-defined unions is emitted (unionS). 

Enum 

Determines what information about user-defined enumerations is emitted (enumS). 
Attribute 

Determines what information about the class’s attributes is emitted (attributes). 
Methods 

Determines what information about the methods of a class is emitted (methodsS). 
More specialized method sections can be specified using inheritedMethodsS or 
overrideMethodsS. 

Release 

Determines how information about the release order statement of a class definition is 
emitted (releases). 

Passthru 

Determines what information about passthru statements is emitted (passthruS). 

Data 

Determines what information about internal instance variables of a class is emitted 

(dataS). 

Interface 

Determines what information about the interfaces in a module is emitted (interfaces). 
Module 

Determines what information about a module is emitted (modules). 

Epilog 

Describes text to be emitted after all other sections are emitted (epilogS). 

Repeating Sections 

Some sections apply to a variable number of items that must be dealt with iteratively. This 
can be true of the base section, as well as the base includes, constant, typedef, struct, 
union, enum, methods, data, passthru, interface and module sections. These repeating 
sections can be preceded by a prolog and followed by an epilog. The SOMTEmitC class 
provides methods for emitting the following prolog and epilog sections: 

basePrologS, baseEpilogS, baselncludesPrologS, baselncludesEpilogS, 
constantPrologS, constantEpilogS, typedefPrologS, typedefEpilogS, 
structPrologS, structEpilogS, unionPrologs, unionEpilogS, enumPrologS, 
enumEpilogS, passthruPrologS, passthruEpilogS, dataPrologS, dataEpilogS, 
attributePrologS, attributeEpilogS, methodsPrologS, methodsEpilogS, 
interfacePrologS, interfaceEpilogS, modulePrologS, moduleEpilogS. 

An emitter typically emits a repeating section as follows: 

• The prolog section, if any, is emitted. 

• The emitter iterates over each item to be described, emitting the section body for each. 

• The epilog section, if any, is emitted. 

To facilitate emitting repeating sections, the SOMTEmitC class provides scanning methods 
that perform the above steps for a particular repeating section. 



File Stem 

scemit 



Chapter 1 . Emitter Framework 23 




SOMTEmitC Class 



Base 

SOMObject 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMObject 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtTemplate 

(SOMTTemplateOutputC) The template for the emitter. 

somtTargetFile 

(FILE) The target file for the emitter. 

somtTargetClass 

(SOMTCIassEntryC) The target class for the emitter. If the emitter is handling a 
module rather than a class, then this attribute is NULL. 

somtTargetModule 

(SOMTModuleEntryC) The target module for the emitter. If the emitter is handling a 
class rather than a module, then this attribute is NULL. 

somtEmitterName 

(string) The name by which the emitter is invoked using the -s option of the sc 
command. This is typically the filestem of the emitter’s .idl file. 

New Methods 

The SOMTEmitC class includes new methods in the framework, sections, scanning and 
filters groups. 

Group: framework 

somtGenerateSections Method 
somtOpenSymboIsFile Method 
somtSetPredefinedSymbols Method 
somtFileSymbols Method 
somtGetGlobalModifierValue Method 
somtGetFirstGlobalDefinition Method 
somtGetNextGlobalDefinition Method 

Group: sections 

somtEmitFullPassthru Method 
somtEmit<Section> Methods 

somtEmitAttributeProlog, somtEmitAttribute, somtEmitAttributeEpilog, 
somtEmitBaseProlog, somtEmitBase, somtEmitBaseEpilog, 
somtEmitBaselncludesProlog, somtEmitBaselncludes, 
somtEmitBaselncludesEpilog, somtEmitClass, somtEmitConstantProlog, 
somtEmitConstant, somtEmitConstantEpilog, somtEmitDataProlog, 
somtEmitData, somtEmitDataEpilog, somtEmitEnumProlog, somtEmitEnum, 
somtEmitEnumEpilog, somtEmitEpilog, somtEmitlnterfaceProlog, 
somtEmitlnterface, somtEmitlnterfaceEpilog, somtEmitMeta, 
somtEmitMetalncludes, somtEmitMethodsProlog, somtEmitMethod, 
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somtEmitMethods, somtEmitMethodsEpilog, somtEmitModuleProlog, 
somtEmitModule, somtEmitModuleEpilog, somtEmitPassthruProlog, 
somtEmitPassthru, somtEmitPassthruEpilog, somtEmitProlog, 
somtEmitRelease, somtEmitStructProlog, somtEmitStruct, 
somtEmitStructEpilog, somtEmitTypedefProlog, somtEmitTypedef, 
somtEmitTypedefEpilog, somtEmitUnionProlog, somtEmitUnion, 
somtEmitUnionEpilog 

Group: scanning 

somtScan<Section> Methods 

somtScan Bases, somtScanBasesF, somtScanConstants, somtScanTypedefs, 
somtScanStructs, somtScanUnions, somtScanEnums, somtScanAttributes, 
somtScan Methods, somtScanData, somtScanDataF, somtScanPassthru, 
somtScanlnterfaces, somtScanModules 



Group: filters 

somtNew Method 
somtlmplemented Method 
somtOverridden Method 
somtlnherited Method 
somtAII Method 
somtNewProc Method 
somtNewNoProc Method 
somtVA Method 

Overriding Methods 

somDefaultlnit Method 
somDestruct Method 
somDumpSelflnt Method 
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somtAII Method 

Checks whether the target class of an emitter supports a specified instance method. 



IDL Syntax 

boolean somtAII (in SOMTMethodEntryC method ); 

Note: This method does not take an Environment parameter. 

Description 

The somtAII method checks whether the target class of an emitter supports a specified 
instance method (whether the method can be invoked on instances of the class). 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

method 

An object of class SOMTMethodEntryC representing a method to be tested. 



Return Value 

The somtAII method returns TRUE if the emitter’s target class supports the specified 
method. Otherwise, it returns FALSE. 



Example 

_somtScanMethods (emitter, "somtAII" , " somtEmitMethodsProlog" , 
" somtEmitMethod" , 

" somtEmitMethodsEpilog" , TRUE ) ; 



Original Class 

SOMTEmitC 

Related Information 

somtOverridden Method 
somtlnherited Method 
somtlmplemented Method 
somtNew Method 
somtNewProc Method 
somtNewNoProc Method 
somtVA Method 
somtScan<Section> Methods 
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somtEmit<Section> Methods 

These methods emit a particular section from an emitter’s template. 



IDL Syntax 

void somtEmitAttribute (in SOMTAttributeEntryC entry); 
void somtEmitAttributeEpilog ( ); 
void somtEmitAttributeProlog ( ); 
void somtEmitBase (in SOMTBaseClassEntryC entry); 
void somtEmitBaseEpilog ( ); 

void somtEmitBaselncludes (in SOMTBaseClassEntryC entry); 
void somtEmitBaselncludesEpilog ( ); 
void somtEmitBaselncludesProlog ( ); 
void somtEmitBaseProlog ( ); 
void somtEmitClass ( ); 

void somtEmitConstant (in SOMTConstEntryC entry); 

void somtEmitConstantEpilog ( ); 

void somtEmitConstantProlog ( ); 

void somtEmitData (in SOMTDataEntryC entry); 

void somtEmitDataEpilog ( ); 

void somtEmitDataProlog ( ); 

void somtEmitEnum (in SOMTEnumEntryC entry); 

void somtEmitEnumEpilog ( ); 

void somtEmitEnumProlog ( ); 

void somtEmitEpilog ( ); 

void somtEmitlnterface (in SOMTCIassEntryC entry); 

void somtEmitlnterfaceEpilog ( ); 

void somtEmitlnterfaceProlog ( ); 

void somtEmitMeta ( ); 

void somtEmitMetalnclude ( ); 

void somtEmitMethod (in SOMTMethodEntryC entry); 

void somtEmitMethods (in SOMTMethodEntryC entry); 

void somtEmitMethodsEpilog ( ); 

void somtEmitMethodsProlog ( ); 

void somtEmitModule (in SOMTModuleEntryC entry); 

void somtEmitModuleEpilog ( ); 

void somtEmitModuleProlog ( ); 

void somtEmitPassthru (in SOMTPassthruEntryC entry); 
void somtEmitPassthruEpilog ( ); 
void somtEmitPassthruProlog ( ); 
void somtEmitProlog ( ); 
void somtEmitRelease ( ); 

void somtEmitStruct (in SOMTStructEntryC entry); 
void somtEmitStructEpilog ( ); 
void somtEmitStructProlog ( ); 

void somtEmitTypedef (in SOMTTypedefEntryC entry); 

void somtEmitTypedefEpilog ( ); 

void somtEmitTypedefProlog ( ); 

void somtEmitUnion (in SOMTUnionEntryC entry); 

void somtEmitUnionEpilog ( ); 

void somtEmitUnionProlog ( ); 

Note: These methods do not take an Environment parameter. 



Chapter 1 . Emitter Framework 27 




somtEmit<Section> Methods 



Description 

The somtEmit <section> methods emit a particular section from an emitter’s template, 
using the somtOutputSection Method. In the case of a repeating section, an entry object 
is passed as a parameter; prior to emitting the section, the somtSetSymbolsOnEntry 
Method is invoked on that entry so that the template symbols used in the section to be 
emitted will correspond to that entry. 

The section emitted by each of these methods is determined by a section-name symbol. To 
change the section to be emitted by a particular method, change the value of the 
corresponding section-name symbol, using somtSetSymbolCopyValue Method, prior to 
invoking the section-emitting method. For example, to have the somtEmitBase method 
emit the mybaseS section of the template instead of the baseS section, which is the 
default, set the baseSN symbol to mybaseS prior to invoking somtEmitBase. 

The somtEmitMethod method emits a specialized methods section for the specified 
method, according to whether the method is new, inherited, or overriding. The specialized 
sections are, by default, methodsS, inheritedMethodsS, and overrideMethodsS, 
depending on the value of section-name symbols methodsSN, inheritedMethodsSN and 
overrideMethodsSN. The somtEmitMethods method, by contrast, emits the generic 
methods section for the specified method. The generic methods section is determined by 
the value of the methodsSN symbol, which is by default methodsS. 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

entry 

An entry object to be used to set the values of the symbols used in the template section 
to be emitted. 



Original Class 

SOMTEmitC 

Related Information 

somtEmitFullPassthru Method 
somtScan<Section> Methods 
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Symbol Name 

attributes 

attributeEpilogSN 

attributePrologSN 

baseSN 

baseEpilogSN 

base Inc ludesSN 

base Inc ludesEpilogSN 

base Inc ludesPrologSN 

basePrologSN 

classSN 

constantSN 

const ant PrologSN 

cons t ant EpilogSN 

dataSN 

dataEpilogSN 

dataPrologSN 

enumSN 

enumEpi logSN 
enumPrologSN 
epilogSN 

inheritedMethodsSN 
interf aceSN 
interf aceEpi logSN 
interf ace PrologSN 
metaSN 

metalncludeSN 

methodsSN 

methodsSN 

me thodsEpi logSN 

methods PrologSN 

moduleSN 

moduleEpi logSN 

modulePrologSN 

over rideMet hods SN 

passthruSN 

pas sthruEpi logSN 

passthruPrologSN 

prologSN 

releaseSN 

structSN 

struct EpilogSN 

struct PrologSN 

typedef SN 

typedef EpilogSN 

typedef PrologSN 

unionEpi logSN 

unionSN 

unionPrologsN 



Initial Value 
(Section Name) 

attributes 

attributeEpilogS 

attributePrologS 

bases 

baseEpilogS 

base Inc ludesS 

base Inc ludesEpi logS 

base Includes Prologs 

basePrologS 

classS 

constants 

const ant Prologs 

const ant EpilogS 

dataS 

dataEpilogS 

dataPrologS 

enumS 

enumEpi logS 
enumPrologS 
epilogS 

inheritedMethodsS 
interfaces 
interf aceEpi logS 
interf ace Prologs 
metaS 

metalncludeS 

methodsS 

methodsS 

me thodsEpi logS 

methods Prologs 

modules 

moduleEpi logS 

modulePrologS 

over rideMet hods S 

passthruS 

pas sthruEpi logS 

passthruPrologS 

prologS 

releases 

structS 

struct EpilogS 

struct Prologs 

typedef S 

typedef EpilogS 

typedef Prologs 

unionEpilogS 

unions 

unionPrologs 



Used by Method 

somt Emit At tribute 

somtEmitAttributeEpilog 

somtEmitAttributeProlog 

somtEmitBase 

somt EmitBaseEpi log 

somtEmitBase Includes 

somtEmitBase Inc ludesEpi log 

somtEmitBase Includes Prolog 

somtEmitBaseProlog 

somt Emit Cl ass 

somt Emit Const ant 

somt Emit Const ant Prolog 

somt Emit Const ant Epilog 

somtEmitData 

somtEmitDataEpilog 

somtEmitDataProlog 

somtEmitEnum 

s omt Emi t EnumEp i 1 og 

somtEmitEnumProlog 

somt Emit Epilog 

somt Emi tMet hod 

somt Emit Interface 

somt Emit Interf aceEpi log 

somt Emit Inter face Prolog 

somtEmitMeta 

somt Emi tMet a Includes 

somt Emi tMet hod 

somt Emi tMet hods 

somt Emi tMe thodsEpi log 

somt Emi tMet hods Prolog 

somt Emi tModule 

somt Emi tModuleEpi log 

somt Emi tModuleProlog 

somt Emi tMet hod 

somt Emit Pass thru 

somt Emit Pas sthruEpi log 

somt Emit Pas sthruProlog 

somt Emit Prolog 

somt Emit Re lease 

somt Emit Struct 

somtEmitStructEpilog 

somt Emit Struct Prolog 

somt Emit Typedef 

somt Emit Typedef Epilog 

somt Emit Typedef Prolog 

somt Emi tUnionEpi log 

somt Emi tUnion 

somt Emi tUnionProlog 
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somtEmitFullPassthru Method 

Emits the passthru section for each of a class’s passthrus having a particular target and 
before/after classification. 



IDL Syntax 

void somtEmitFullPassthru (in boolean before, in string language); 

Note: This method does not take an Environment parameter. 

Description 

The somtEmitFullPassthru method emits the passthru section for each passthru item 
defined for an emitter’s target class that has the specified target language and the specified 
before/after setting and whose target is the emitter on which the method is invoked. 

The somtlsBeforePassthru Method is used to check that passthru entries match the 
before parameter. The somtPassthruLanguage attribute of each passthru entry is 
matched against the language parameter. The somtPassthruTarget attribute of each 
passthru entry is matched against the somtEmitterName attribute of the emitter on which 
the method is invoked. 

This method first invokes the somtEmitPassthruProlog method. Then, for each passthru 
entry that satisfies the above requirements, this method invokes the somtEmitPassthru 
method. Finally, it invokes the somtEmitPassthruEpilog method. 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

before 

Whether before (TRUE) or after (FALSE) passthrus are to be emitted. 

language 

The target language of the passthrus for which sections are to be emitted (in upper 
case only). “C” is used for both C and C++. 

Example 

set_somtEmitterName (emitter , "mine") ; 

set_somtTargetClass (emitter , oCls) ; 

set_somtTargetFile (emitter , fp) ; 

_somtEmitFullPassthru (emitter , TRUE, "C"); 



Original Class 

SOMTEmitC 

Related Information 

somtEmitPassthruProlog 

somtEmitPassthruEpilog 
somtEmitPassthru 
somtlsBeforePassthru Method 
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somtFileSymbols Method 

Sets predefined symbols that have a single value in all sections of the output template. 

IDL Syntax 

void somtFileSymbols ( ); 

Description 

The somtFileSymbols method sets predefined symbols that have a single value in all 
sections of the output template. This includes symbols for the target class or target module, 
symbols for the metaclass of the target class, if any, and special symbols like timestamp. 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

Example 

emitter = MyEmitterNew ( ) ; 

set_somtTargetFile (emitter , fp) ; 

set_somtTargetClass (emitter , oCls) ; 

_somtFileSymbols (emitter) ; 

Original Class 

SOMTEmitC 
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somtGenerateSections Method 

Calls each of the section-emitting methods. 

IDL Syntax 

boolean somtGenerateSections ( ); 

Note: This method does not take an Environment parameter. 

Description 

The default implementation calls each of the section-emitting methods in the following order: 

For emitters having a target class: 

somtEmitProlog 

somtEmitBaselncludes, (for each base class) 

somtEmitBaselncludesEpilog 

somtEmitMetalnclude 

somtEmitClass 

somtEmitBaseProlog 

somtEmitBase (for each base class) 

somtEmitBaseEpilog 

somtEmitMeta 

somtEmitConstantProlog 

somtEmitConstant (for each constant) 

somtEmitConstantEpilog 

somtEmitTypedefProlog 

somtEmitTypedef (for each typedef) 

somtEmitTypedefEpilog 

somtEmitStructProlog 

somtEmitStruct (for each struct) 

somtEmitStructEpilog 

somtEmitUnionProlog 

somtEmitUnion (for each union) 

somtEmitUnionEpilog 

somtEmitEnumProlog 

somtEmitEnum (for each enum) 

somtEmitEnumEpilog 

somtEmitAttributeProlog 

somtEmitAttribute (for each attribute) 

somtEmitAttributeEpilog 

somtEmitMethodsProlog 

somtEmitMethod (for each method) 

somtEmitMethodsEpilog 

somtEmitRelease 

somtEmitPassthruProlog 

somtEmitPassthru (for each passthru item) 

somtEmitPassthruEpilog 

somtEmitDataProlog 

somtEmitData (for each data item) 

somtEmitDataEpilog 

somtEmitEpilog 

For emitters having a target module: 

somtEmitProlog 
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somtGenerateSections Method 



somtEmitConstantProlog 

somtEmitConstant (for each constant) 

somtEmitConstantEpilog 

somtEmitTypedefProlog 

somtEmitTypedef (for each typedef) 

somtEmitTypedefEpilog 

somtEmitStructProlog 

somtEmitStruct (for each struct) 

somtEmitStructEpilog 

somtEmitUnionProlog 

somtEmitUnion (for each union) 

somtEmitUnionEpilog 

somtEmitEnumProlog 

somtEmitEnum (for each enum) 

somtEmitEnumEpilog 

somtEmitlnterfaceProlog 

somtEmitlnterface (for each interface) 

somtEmitlnterfaceEpilog 

somtEmitModuleProlog 

somtEmitModule (for each embedded module) 

somtEmitModuleEpilog 

somtEmitEpilog 

Repeating sections (such as somtEmitBase) are emitted using the corresponding 

somtScan<Section> Methods. 

To rearrange the order of sections, or to add or delete sections in your emitter, override the 

somtGenerateSections method. 



Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 



Return Value 

The somtGenerateSections method returns TRUE. 

Original Class 

SOMTEmitC 

Related Information 

somtEmit<Section> Methods 
somtEmitFullPassthru Method 
somtScan<Section> Methods 
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somtGetFirstGlobalDefinition Method 

Returns the first type, constant, exception or forward declaration not associated with an 
interface or module. 



IDL Syntax 

SOMTEntryC somtGetFirstGlobalDefinition ( ); 

Note: This method does not take an Environment parameter. 



Description 

Returns the first type, constant, exception or forward declaration not associated with any 
interface or module. Type declarations include struct and union declarations. In the IDL 
source file, these global declarations must be surrounded by #pragma somemittypes 
statements to be visible via this method: 

#pragma somemittypes on 

typedef sequence <long,10> veclO; 

exception BAD_FLAG { long ErrCode; char Reason [80]; }; 

typedef long long_t; 

#pragma somemittypes off 



Parameters 

receiver 

A pointer to an object of class SOMTEmitC representing an emitter. 



Return Value 

Returns a pointer to an object of class SOMTEntryC representing the first global type, 
constant, exception or forward declaration in the receiver. 



Example 

SOMTEntryC entry; 

for (entry = _somtGetFirstGlobalDef inition (emitter) ; 

entry; entry = _somtGetNextGlobalDef inition (emitter) ) 

if (( get_somtElementType (entry) == SOMTClassE) && 

get_somtForwardRef (entry) ) 

/* "entry" represents a forward declaration 
* for a class; handle it appropriately 
*/ 

else 

/* "entry" represents something else, such as a 

* constant, typedef, etc. Determine what it 

* represents using get_somtElementType as 

* above and handle it appropriately. 

*/ 

Original Class 

SOMTEmitC 

Related Information 

somtGetNextGlobalDef inition Method 
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somtGetGlobalModifierValue Method 

Gets the value of a global modifier specified via the -m option when the SOM Compiler is 
invoked. 



IDL Syntax 

string somtGetGlobalModifierValue (in string modifierName)', 

Note: This method does not take an Environment parameter. 

Description 

The somtGetGlobalModifierValue method gets the value of a global modifier specified via 
the -m option when the SOM Compiler is invoked. For example, 

sc -m"foo=bar" file.idl 

specifies to the SOM Compiler that the global modifier f oo has the value bar. Values of 
global modifiers are transient; they last only for the duration of the compile for which they 
were specified. If a modifier is specified with no value (for modifiers that are boolean), as in 

sc -mfoo file.idl 

then the result of this method will be non-NULL. If the requested modifier was not specified 
in the sc command, then the result of this method is NULL. 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

modifierName 

The name of the global modifier whose value is needed. 



Return Value 

The value of the global modifier is returned. If the modifier is present but has no value (for 
modifiers that are boolean), the result of this method will be non-NULL. If the requested 
modifier was not specified in the sc command, then the result of this method is NULL. 

Original Class 

SOMTEmitC 
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somtGetNextGlobalDefinition Method 

Returns the next type, constant, exception, or forward declaration that is not associated 
with any interface or module, relative to a similar, preceding call. 



IDL Syntax 

SOMTEntryC somtGetNextGlobalDefinition ( ); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetNextGlobalDefinition method returns the next type, constant, exception, or 
forward declaration that is not associated with any interface or module, relative to a prior 
call to method somtGetFirstGlobalDefinition or somtGetNextGlobalDefinition. In the 
IDL source file, these global declarations must be surrounded by #pragma somemittypes 
statements for them to be visible via this method. 

Parameters 

receiver 

A pointer to an object of class SOMTEmitC representing an emitter. 



Return Value 

The somtGetNextGlobalDefinition method returns a pointer to an object of SOMTEntryC 
representing the next global type, constant, exception, or forward declaration in the 
receiver, relative to a previous call to either method somtGetFirstGlobalDefinition or 
somtGetNextGlobalDefinition. 



Example 

SOMTEntryC entry; 

for (entry = _somtGetFirstGlobalDef inition (emitter) ; 

entry; entry = _somtGetNextGlobalDef inition (emitter) ) 

if (( get_somtElementType (entry) == SOMTClassE) && 

get_somtForwardRef (entry) ) 

/* "entry" represents a forward declaration 
* for a class; handle it appropriately 
*/ 

else 

/* "entry" represents something else, such as a 

* constant, typedef, etc. Determine what it 

* represents using get_somtElementType as 

* above and handle it appropriately. 

*/ 



Original Class 

SOMTEmitC 

Related Information 

somtGetFirstGlobalDefinition Method 
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somtlmplemented Method 

Checks whether the target class of an emitter introduces or overrides a specified method. 



IDL Syntax 

boolean somtlmplemented (in SOMTMethodEntryC method ); 

Note: This method does not take an Environment parameter. 

Description 

The somtlmplemented method checks whether the target class of the receiver introduces 
or overrides the method specified by method. 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

method 

An object of class SOMTMethodEntryC representing the method to be tested. 



Return Value 

The somtlmplemented method returns TRUE if the emitter’s target class introduces or 
overrides the specified method. Otherwise, it returns FALSE. 



Example 

_somtScanMethods ( emitter , " somtlmplemented" , 

" somtEmitMethodsProlog" , 

" somtEmitMethod" , 

" somtEmitMethodsEpilog" , TRUE ) ; 

Original Class 

SOMTEmitC 

Related Information 

somtAII Method 
somtlnherited Method 
somtOverridden Method 
somtNew Method 
somtNewNoProc Method 
somtNewProc Method 
somtVA Method 
somtScan<Section> Methods 
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somtlnherited Method 

Checks whether the target class of an emitter inherits a specified method. 



IDL Syntax 

boolean somtlnherited (in SOMTMethodEntryC method); 

Note: This method does not take an Environment parameter. 

Description 

The somtlnherited method checks whether the target class of an emitter inherits a 
specified method. 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

method 

An object of class SOMTMethodEntryC representing the method to be tested. 



Return Value 

The somtlnherited method returns TRUE if the emitter’s target class inherits the specified 
method. Otherwise, it returns FALSE. 



Example 

_somtScanMethods (emitter, "somtlnherited" , 

" somtEmitMethodsProlog" , 

" somtEmitMethod" , 

" somtEmitMethodsEpilog" , TRUE ) ; 

Original Class 

SOMTEmitC 

Related Information 

somtAII Method 
somtOverridden Method 
somtlmplemented Method 
somtNew Method 
somtNewNoProc Method 
somtNewProc Method 
somtVA Method 
somtScan<Section> Methods 
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somtNew Method 

Checks whether a method is newly defined (introduced) by an emitter’s target class. 



IDL Syntax 

boolean somtNew (in SOMTMethodEntryC method ); 

Note: This method does not take an Environment parameter. 

Description 

The somtNew method tests whether a method is newly defined (introduced) by an emitter’s 
target class. 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

method 

An object of class SOMTMethodEntryC representing the method to be tested. 



Return Value 

The somtNew method returns TRUE if the specified method is introduced by the emitter’s 
target class. 



Example 

SOMTMethodEntryC mp; 

mp = _somtGetFirstMethod ( get_somtTargetClass (emitter) ) ; 

if (_somtNew (emitter , mp) ) /* Check to see if method is new. */ 

{ 

_somtSetSymbolsOnEntry (mp , emitter, "method"); 
_somtEmitMethod (emitter , mp) ; 

} 



Original Class 

SOMTEmitC 

Related Information 

somtAII Method 
somtlnherited Method 
somtlmplemented Method 
somtOverridden Method 
somtNewNoProc Method 
somtNewProc Method 
somtVA Method 
somtScan<Section> Methods 
somtFilterNew Method 
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somtNewNoProc Method 

Checks whether a method is newly defined (introduced) by an emitter’s target class and 
whether the method is a true method, and not a direct-call procedure. 



IDL Syntax 

boolean somtNewNoProc (in SOMTEntryC method ); 

Note: This method does not take an Environment parameter. 

Description 

The somtNewNoProc method tests whether a method is newly defined (introduced) by an 
emitter’s target class and whether the method is a true method, and not a direct-call 
procedure (as determined by the absence of the procedure SOM IDL method modifier in 
the .idl file). 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

method 

An object of class SOMTEntryC representing the method to be tested. 



Return Value 

The somtNewNoProc method returns TRUE if the specified method is introduced by the 
emitter’s target class and the method is not a direct-call procedure. Otherwise, it returns 
FALSE. 



Example 

SOMTClassEntryC els = get_somtTargetClass (emitter ) ; 

SOMTMethodEntryC method; 

method = _somtGetFirstMethod (els) ; 

if (_somtNewNoProc (emitter , method)) 

printf ( "Method %s is really a method!. \n" , 

get_somtEntryName (method) ) ; 



Original Class 

SOMTEmitC 

Related Information 

somtOverridden Method 
somtlnherited Method 
somtlmplemented Method 
somtNew Method 
somtNewProc Method 
somtVA Method 
somtScan<Section> Methods 
somtFilterNew Method 
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somtNewProc Method 

Checks whether a method is newly defined (introduced) by an emitter’s target class and 
whether the method is a direct-call procedure. 



IDL Syntax 

boolean somtNewProc (in SOMTEntryC method ); 

Note: This method does not take an Environment parameter. 

Description 

The somtNewProc method tests whether a method is newly defined (introduced) by an 
emitter’s target class and whether the method is a direct-call procedure (it has the 
procedure SOM IDL method modifier in the .idl file). 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

method 

An object of class SOMTEntryC representing the method to be tested. 



Return Value 

The somtNewProc method returns TRUE if the specified method is introduced by the 
emitter’s target class and the method is a direct-call procedure. Otherwise, it returns FALSE. 



Example 

SOMTClassEntryC els = get_somtTargetClass (emitter ) ; 

SOMTMethodEntryC method; 

method = _somtGetFirstMethod (els) ; 

if (_somtNewProc (emitter , method)) 

printf ( "Method %s is really a direct-call procedure . \n" , 
get_somtEntryName (method) ) ; 



Original Class 

SOMTEmitC 

Related Information 

somtAII Method 
somtlnherited Method 
somtOverridden Method 
somtlmplemented Method 
somtNew Method 
somtNewNoProc Method 
somtVA Method 
somtScan<Section> Methods 
somtFilterNew Method 
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somtOpenSymboIsFile Method 

Opens the symbols file of an emitter. 



IDL Syntax 

FILE *somtOpenSymbolsFile (in string fileName, in string mode ); 

Note: This method does not take an Environment parameter. 

Description 

The somtOpenSymboIsFile method opens an emitter’s symbol file (the file containing the 
template definitions). If the specified file does not exist in the current working directory, then 
the method attempts to find the file in the directories specified in the SMINCLUDE 
environment variable. 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

fileName 

A string representing the name of the file to be opened. 

mode 

A string indicating the mode in which the file should be opened (usually “r” for read 
only). This parameter is passed to the standard C library fopen function. 

Return Value 

A pointer to the open file is returned. If the file is not found, NULL is returned. 



Example 

FILE *fp; 

SOMTTemplateOutputC template = get_somtTemplate (emitter) ; 

fp = _somtOpenSymbolsFile (emitter , "myf ile . efw" , "r"); 
_somtReadSectionDef initions (template , fp) ; 
f close ( fp) ; 



Original Class 

SOMTEmitC 

Related Information 

somtReadSectionDef initions Method 
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somtOverridden Method 

Checks whether the specified method is an overriding method of the target class of an 
emitter. 



IDL Syntax 

boolean somtOverridden (in SOMTMethodEntryC method ); 

Note: This method does not take an Environment parameter. 

Description 

The somtOverridden method checks whether method represents an overriding method of 
the target class of the emitter on which the method is invoked. 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

method 

An object of class SOMTMethodEntryC representing the method to be tested. 



Return Value 

The somtOverridden method returns TRUE if the emitter’s target class overrides the 
specified method. Otherwise, it returns FALSE. 



Example 

SOMTClassEntryC els = get_somtTargetClass (emitter ) ; 

SOMTMethodEntryC method; 

method = _somtGetFirstMethod (els) ; 

if (_somtOverridden (emitter , method)) 

printf ( "Method %s is an overriding method. \n" , 

get_somtEntryName (method) ) ; 



Original Class 

SOMTEmitC 

Related Information 

somtAII Method 
somtlnherited Method 
somtlmplemented Method 
somtNew Method 
somtNewNoProc Method 
somtNewProc Method 
somtVA Method 
somtScan<Section> Methods 
somtFilterOverridden Method 
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somtScan <Section> Methods 

These methods emit a particular repeating section of an emitter’s template for each item to 
which that section applies, with the appropriate prolog and epilog sections. 



IDL Syntax 



boolean somtScanBases (in string prolog, in string each, in string epilog)-, 
boolean somtScanBasesF (in string filter, in string prolog, in string each, 

in string epilog, in boolean forceProlog)-, 
boolean somtScanData (in string prolog, in string each, in string epilog)-, 
boolean somtScanDataF (in string filter, 

in string prolog, in string each, in string epilog, 
in boolean forceProlog)-, 
boolean somtScanMethods (in string filter, 

in string prolog, in string each, in string epilog, 
in boolean forceProlog)-, 
boolean somtScanPassthru (in boolean before, 

in string prolog, in string each, in string epilog)-, 
boolean somtScanConstants (in string prolog, in string each, in string epilog)-, 
boolean somtScanTypedefs (in string prolog, in string each, in string epilog)-, 
boolean somtScanStructs (in string prolog, in string each, in string epilog)-, 
boolean somtScanUnions (in string prolog, in string each, in string epilog)-, 
boolean somtScanEnums (in string prolog, in string each, in string epilog)-, 
boolean somtScanAttributes (in string prolog, in string each, in string epilog)-, 
boolean somtScanlnterfaces (in string prolog, in string each, in string epilog)-, 
boolean somtScanModules (in string prolog, in string each, in string epilog)-, 



Note: These methods do not take an Environment parameter. 



Description 

The somtScan<Section> methods iterate through a repeating section for each item of the 
emitter’s target class or module to which the repeating section applies. The 
somtScanBases method iterates through the base classes of the emitter’s target class, 
calling the section-emitting method whose name is specified by each for each one. 

Prior to emitting the first repeating section, the specified prolog-emitting method is invoked. 
After emitting the final repeating section, the specified epilog-emitting method is called. 
Methods whose names are suitable for passing as values of the prolog, each, and epilog 
parameters are the somtEmit<Section> Methods provided by the Emitter Framework; 
user-written methods having the same signature as those methods can also be used. 

For scanning methods that have a filter parameter, a section is emitted only for entries that 
satisfy the specified filter method. The following methods are suitable for passing as a filter: 
somtNew, somtlmplemented, somtOverridden, somtlnherited, somtAII, 
somtNewProc, somtNewNoProc and somtVA. User-written methods having the same 
signature as those methods can be used. For methods that have a forceProlog parameter, 
if forceProlog is FALSE, the prolog and epilog sections are emitted only if there is at least 
one entry that satisfies the specified filter method. 

The somtScanPassthru method only emits sections for passthru items for which the 

somtlsBeforePassthru Method returns the same value as given for somtScanPassthru’s 
before parameter. 

The somtScanBases, somtScanBasesF, somtScanAttributes, somtScanMethods, 
somtScanData, somtScanDataF and somtScanPassthru methods must only be invoked 
on an emitter whose target class is not NULL. The somtScanlnterfaces and 
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somtScan<Section> Methods 



somtScanModules methods must only be invoked on an emitter whose target module is 
not NULL 



Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

prolog 

A string representing the name of a prolog-emitting method. 

each 

A string representing the name of a repeating-section emitting method. 

epilog 

A string representing the name of an epilog-emitting method. 

filter 

A string representing the name of a filter method. 

forceProlog 

A boolean indicating whether or not to emit the prolog and epilog sections if the 
emitter’s target class/module has no entries that satisfy the specified filter. 

before 

A boolean indicating whether to emit passthru sections for before passthru items 
(TRUE) or for after passthru items (FALSE). 



Return Value 

The somtScan<Section> methods return TRUE. 



Example 

To scan the new methods of a class: 

_somtScanMethods (emitter, 

" somtNew" , 

" somtEmitMethodsProlog" , 
" somtEmitMethod" , 

" somtEmitMethodsEpilog" , 
FALSE) ; 

Original Class 

SOMTEmitC 

Related Information 

somtEmit<Section> Methods 
somtNew Method 
somtlmplemented Method 
somtOverridden Method 
somtlnherited Method 
somtAII Method 
somtNewProc Method 
somtNewNoProc Method 
somtVA Method 
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somtSetPredefinedSymbols Method 

Sets predefined symbols used for section names. 



IDL Syntax 

void somtSetPredefinedSymbols ( ); 

Note: This method does not take an Environment parameter. 

Description 

The somtSetPredefinedSymbols method sets predefined symbols used for section 
names. These symbols are used by the section-emitting methods of SOMTEmitC to 
determine the section to emit. For example, the somtEmitProlog method uses the value of 
the prologSN symbol to determine what section to emit. The somtSetPredefinedSymbols 
method sets the prologSN symbol to the value prologS, so that the somtEmitProlog 
method by default emits the prologS section. 

Parameters 

receiver 

A pointer to an object of class SOMTEmitC representing an emitter. 



Original Class 

SOMTEmitC 

Related Information 

somtFileSymbols Method 
somtEmit<Section> Methods 
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somtVA Method 

Checks whether a method accepts a variable number of arguments. 



IDL Syntax 

boolean somtVA (in SOMTEntryC method ); 

Note: This method does not take an Environment parameter. 

Description 

The somtVA method checks whether the specified method is a varargs method (that is, 
whether it accepts a variable number of arguments). 

Parameters 

receiver 

An object of class SOMTEmitC representing an emitter. 

method 

An object of class SOMTEntryC representing the method to be tested. 



Return Value 

The somtVA method returns TRUE if the specified method accepts a variable number of 
arguments. Otherwise, it returns FALSE. 



Example 

SOMTClassEntryC els = get_somtTargetClass (emitter ) ; 

SOMTMethodEntryC method; 

method = _somtGetFirstMethod (els) ; 

if (_somtVA (emitter , method)) 

printf ( "Method %s takes a variable number of arguments . \n" , 
get_somtEntryName (method) ) ; 



Original Class 

SOMTEmitC 

Related Information 

somtlnherited Method 
somtlmplemented Method 
somtNew Method 
somtNewProc Method 
somtNewNoProc Method 
somtOverridden Method 
somtScan<Section> Methods 
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SOMTEntryC Class 

The SOM Compiler compiles a class interface definition in IDL to produce a graph structure 
whose nodes are instances of SOMTEntryC or its subclasses. Each entry is derived from a 
portion of the IDL definition to which the attributes defined in SOMTEntryC and its 
subclasses refer. Thus, a SOMTEntryC object serves to hide the syntax of the class IDL. 

The SOMTEntryC class provides methods for accessing information about particular 
portions of a class definition: the line number, its accompanying comment, its SOM IDL 
modifiers, its name (both scoped and unscoped) and the kind of entity represented. 



File Stem 

scentry 

Base 

SOMObject 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMObject 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtEntryName 

(string) The unscoped name of the entry. 

somtIDLScopedName 

(string) The scoped name of the entry, in IDL form (using as the delimiter). 

somtCScoped Name 

(string) The scoped name of the entry, in C form (with underscore as the delimiter). 
This attribute has no set method. 

somtElementType 

(SOMTTypes) The type of the entry (class, method, attribute, typedef, etc.). 

somtElementTypeName 

(string) The string form of somtElementType. 

somtEntryComment 

(string) The comment associated with the entry or NULL. Comments have comment 
delimiters removed but retain newline characters. 

somtSourceLineNumber 

(unsigned long) The line number in the source file where this entry’s syntactic form 
ends. 

somtTypeCode 

(TypeCode) The type code, if appropriate, or NULL 

somtlsReference 

(boolean) Whether this entry represents a type reference rather than a declaration of it. 
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New Methods 

somtGetModifierValue Method 
somtGetFirstModifier Method 
somtGetNextModifier Method 
somtFormatModifier Method 
somtGetModifierList Method 
somtSetSymbolsOnEntry Method 

Overriding Methods 

somDefaultlnit Method 
somDestruct Method 
somPrintSelf Method 
somDumpSelflnt Method 
somDumpSelf Method 
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somtFormatModifier Method 

Formats a SOM IDL modifier name/value pair into a buffer. 



IDL Syntax 

long somtFormatModifier (in string buffer, 
in string name, in string value); 

Note: This method does not take an Environment parameter. 

Description 

The somtFormatModifier method formats the specified SOM IDL modifier name/value pair 
into the specified buffer. The buffer must be large enough to hold the formatted pair; no 
checks are made to ensure that it is large enough. The method returns the number of 
characters stored in the buffer, not including the terminating NULL character. 

The somtFormatModifier method is not intended to be invoked directly, but it can be 
overridden by subclasses of SOMTEntryC to control the format returned by the method 

somtGetModifierList. 

Parameters 

receiver 

An object of class SOMTEntryC. 
buffer 

The address of a character buffer where the formatted output will be stored. 

name 

A character string representing the modifier name. 

value 

A character string representing the modifier value. 

Return Value 

The somtFormatModifier method stores the formatted modifier name/value pair in the 
specified buffer and returns the number of characters stored in the buffer, not including the 
terminating NULL character. 

Original Class 

SOMTEntryC 

Related Information 

somtGetModifierValue Method 
somtGetFirstModifier Method 
somtGetNextModifier Method 
somtGetModifierList Method 
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somtGetFirstModifier Method 

The somtGetFirstModifier method gets the first modifier for a particular entry. 



IDL Syntax 

boolean somtGetFirstModifier (inout string modifierName, 

inout string modifierValue); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetFirstModifier method gets the first modifier for the entry specified by 
receiver, if it has one. Otherwise, it returns FALSE. The next modifier can be obtained using 
the corresponding somtGetNextModifier Method. 

The somtGetFirstModifier and somtGetNextModifier methods cannot be used in doubly 
nested loops. For example, the following doubly nested loop will not work, because 
following the first execution of the inner loop, the invocation of somtGetNextModifier in the 
outer loop will return FALSE: 

for (ml = _somtGetFirstModif ier (els , &name, &value) ; ml; 
ml = _somtGetNextModif ier (els , &name, &value) ) 
for (m2 = _somtGetFirstModif ier (els , &name, &value) ; m2; 
m2 = _somtGetNextModif ier (els , &name, &value) ) 

/* etc. */ 

Nested loops such as the one above are permissible if the target object of the inner loop 
differs from the target object of the outer loop, or if a different somtGetFirst<ltem> method 
is used in the inner loop. 

The somtGetFirstModifier method accesses the first SOM IDL modifier of the specified 
entry. The address of a buffer containing the name of the modifier is stored in the location 
pointed to by modifierName, and the address of a buffer containing the value of the modifier 
is stored in the location pointed to by modifierValue. 

Parameters 

receiver 

The entry whose first modifier is to be retrieved. 

modifierName 

A pointer to a location where the address of a buffer containing the modifier name will 
be placed. 

modifierValue 

A pointer to a location where the address of a buffer containing the modifier value will 
be placed. 



Return Value 

This method returns TRUE if a modifier name/value pair was retrieved, or FALSE if the 
specified entry has no modifiers. 



Example 

To iterate through the modifiers of a class: 

boolean done; 
string name, value; 

printf ( "List of modifiers : \n" ) ; 

for (done = _somtGetFirstModif ier (els , &name, &value) ; done; 
done = _somtGetNextModif ier (els , &name, &value) ) 
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printf(" modifier %s has value %s.\n", name, value) 

Related Information 

somtGetNextModifier Method 



52 Programmer ’s Reference for SOM Emitter 




somtGetModifierList Method 



somtGetModifierList Method 

Gets the SOM IDL modifiers for an entry. 



IDL Syntax 

long somtGetModifierList (in string buffer); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetModifierList method stores the SOM IDL modifiers for the specified 
SOMTEntryC object in the specified buffer, separated by newline characters. The buffer 
must be large enough to hold all the modifiers; no checks are made to ensure that the 
buffer is large enough. The method returns the number of modifiers stored in the buffer. 

Parameters 

receiver 

An object of class SOMTEntryC representing the entry whose modifiers are needed. 

buffer 

A pointer to a character buffer where the modifier list will be stored. 



Return Value 

The somtGetModifierList method stores the modifiers for the specified SOMTEntryC 
object in the specified buffer and returns the number of modifiers stored in the buffer. 

Original Class 

SOMTEntryC 

Related Information 

somtFormatModifier Method 
somtGetFirstModifier Method 
somtGetModifierValue Method 
somtGetNextModifier Method 
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somtGetModifierValue Method 

Gets the value of a SOM IDL modifier for an entry. 



IDL Syntax 

string somtGetModifierValue (in string modifierName); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetModifierValue method returns the value of the SOM IDL modifier named 
modifierName if the entry has that modifier in the .idl file. Otherwise, it returns NULL. 

Parameters 

receiver 

An object of class SOMTEntryC representing the entry whose modifier is needed. 

modifierName 

A string representing the name of the modifier whose value is needed. 



Return Value 

The somtGetModifierValue method returns a string representing the value of the specified 
modifier, if the receiver has that modifier. Otherwise, it returns NULL. If the modifier is 
present but has no value, then a non-NULL value is returned. 

Original Class 

SOMTEntryC 

Related Information 

somtFormatModifier Method 
somtGetFirstModifier Method 
somtGetModifierList Method 
somtGetNextModifier Method 
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somtGetNextModifier Method 

This method gets the next modifier for a particular entry, relative to the previous call for a 
modifier. 



IDL Syntax 

boolean somtGetNextModifier (inout string modifierName, 

inout string modifierValue); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetNextModifier methods return the next modifier for the entry on which the 
method was invoked, if it has a next modifier. Otherwise, it returns FALSE. 

A call to a somtGetNextModifier method is relative to the last call of either the same 
method or the corresponding somtGetFirstModifier Method, applied to the same entry 
object. Note that this implies that the somtGetFirstModifier and somtGetNextModifier 
methods cannot be used in doubly nested loops. For example, the following doubly nested 
loop will not work, because following the first execution of the inner loop, the invocation of 
somtGetNextModifier in the outer loop will return FALSE: 

for (ml = _somtGetFirstModif ier (els , &name, &value) ; ml; 
ml = _somtGetNextModif ier (els , &name, &value) ) 
for (m2 = _somtGetFirstModif ier (els , &name, &value) ; m2; 
m2 =: _somtGetNextModif ier (els , &name, &value) ) 

/* etc. */ 

Nested loops such as the one above are permissible if the target object of the inner loop 
differs from the target object of the outer loop, or if a different somtGetFirst<ltem> method 
is used in the inner loop. 

The somtGetNextModifier method accesses the next SOM IDL modifier of the specified 
entry, relative to the last call to somtGetFirstModifier or somtGetNextModifier on the 
same entry. The address of a buffer containing the name of the modifier is stored in the 
location pointed to by modifierName, and the address of a buffer containing the value of the 
modifier is stored in the location pointed to by modifierValue. If the specified entry had at 
least one more modifier, the method returns TRUE. Otherwise, it returns FALSE. 

Parameters 

receiver 

The entry whose next modifier is to be retrieved. 

modifierName 

A pointer to a location where the address of a buffer containing the modifier name will 
be placed. 

modifierValue 

A pointer to a location where the address of a buffer containing the modifier value will 
be placed. 



Return Value 

This method returns TRUE if a modifier name/value pair was retrieved, or FALSE is the 
specified entry has no next modifier. 



Example 

To iterate through the modifiers of a class: 

boolean done; 
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string name, value; 
printf("List of modifiers : \n" ) ; 

for (done = _somtGetFirstModif ier (els , &name, &value) ; done 
done = somtGetNextModif ier (els , &name, &value) ) 
printf(" modifier %s has value %s.\n", name, value); 



Related Information 

somtGetFirstModifier Method 
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somtSetSymbolsOnEntry Method 

Places predefined symbol/value pairs for an entry into the symbol table. 



IDL Syntax 

long somtSetSymbolsOnEntry (in SOMTEmitC emitter, in string prefix); 

Note: This method does not take an Environment parameter. 

Description 

The somtSetSymbolsOnEntry method places predefined pairs for the specified entry in 
the specified emitter’s symbol table. In default implementation, all symbol names begin with 
the string specified in prefix. For example, SOMTEntryC implementation of 
somtSetSymbolsOnEntry defines the prefix Name and pre/rxComment symbols. Hence, 
when invoked on a SOMTCIassEntryC object with prefix = class , this method 
defines symbols className and classComment for the entry. 

This method is invoked by the somtEmit<Section> Methods that takes an entry as an 
additional parameter. The symbols will be defined for that entry when the section is emitted. 
For example, the somtEmitBase method invokes somtSetSymbolsOnEntry on the 
SOMTBaseClassEntryC object passed to it prior to emitting the baseS section. The 
symbols used within the baseS section will have values appropriate for the base-class entry. 

This method can be overridden in subclasses of SOMTEntryC, or subclasses of any of its 
subclasses, to define additional symbols or to change the default symbol settings. 

Overriding methods should invoke the parent method either before or after defining new 
symbols. 

Parameters 

receiver 

An object of class SOMTEntryC for which symbols are to be defined. 

emitter 

An object of class SOMTEmitC representing an emitter. 

prefix 

A string representing the symbol-name prefix to be used. 

Return Value 

The somtSetSymbolsOnEntry method returns 1. 



Example 

SOMTMethodEntryC method; 

SOMTCIassEntryC class = get_somtTargetClass (emitter) ; 

SOMTTemplateOutputC template = get_somtTemplate (emitter) ; 

for (method = _somtGetFirstMethod (class) ; method; 
method = _somtGetNextMethod (class) ) 

{ 

_somtSetSymbolsOnEntry (method, emitter, "method"); 
_somtOutputSect ion (template , "myMethodSection" ) ; 

} 

Original Class 

SOMTEntryC 
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Related Information 

somtExpandSymbol Method 
somtCheckSymbol Method 
somtSetSymbolCopyBoth Method 
somtSetSymbolCopyValue Method 
somtGetSymbol Method 
somtSetSymbol Method 
somtSetSymbolCopyName Method 
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SOMTEnumEntryC Class 

A SOMTEnumEntryC object represents an enumeration definition. It provides methods for 
accessing the enumerator names within the enumeration. 

File Stem 

scenum 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMTEntryC Class 
SOMObject 

Attributes 

None. 

New Methods 

somtGetFirstEnumName Method 
somtGetNextEnumName Method 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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somtGetFirstEnumName Method 

Gets the first enumerator name for a SOMTEnumEntryC object. 



IDL Syntax 

SOMTEnumNameEntryC somtGetFirstEnumName ( ); 

This method does not take an Environment parameter. 

Description 

The somtGetFirstEnumName method returns the first enumerator name for the entry on 
which the method was invoked. The next enumerator name can be obtained using the 
corresponding somtGetNextEnumName method. 

The somtGetFirstEnumName and somtGetNextEnumName methods cannot be used in 
doubly nested loops. For example, the following doubly nested loop will not work, because 
following the first execution of the inner loop, the invocation of somtGetNextEnumName in 
the outer loop will return NULL: 

for (el = _somtGetFirstEnumName (enum) ; el; 
el = —SomtGetNextEnumName (enum) ) 
for (e2 = —SomtGetFirstEnumName (enum) ; e2 ; 
e2 = —SomtGetNextEnumName (enum) ) 

/* etc. */ 

Parameters 

receiver 

The enumeration entry whose first enumerator name is to be retrieved. 



Return Value 

This method returns the first enumerator name for the specified enumeration entry. 



Example 

To iterate through the enumerator names of an enumeration entry: 

SOMTEnumNameEntryC myEntry; 

printf ("List of enumerator names:\n"); 
for (myEntry = —SomtGetFirstEnumName (enum) ; myEntry; 
myEntry = —SomtGetNextEnumName (enum) ) 
printf ("%s\n" , get_ somtEntryName (myEntry) ) ; 



Related Information 

somtGetNextEnumName Method 
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somtGetNextEnumName Method 

Gets the next enumerator name for an enumeration entry, relative to the previous call for an 
enumerator name. 



IDL Syntax 

SOMTEnumNameEntryC somtGetNextEnumName ( ); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetNextEnumName method returns the next enumerator name for the entry on 
which the method was invoked, if it has a next enumerator name. Otherwise, it returns 
NULL 

A call to a somtGetNextEnumName method is relative to the last call of either the same 
method or the corresponding somtGetFirstEnumName method, applied to the same entry 
object. This implies that the somtGetFirstEnumName and somtGetNextEnumName 
methods cannot be used in doubly nested loops. For example, the following doubly nested 
loop will not work, because following the first execution of the inner loop, the invocation of 
somtGetNextEnumName in the outer loop will return NULL: 

for (el = _somtGetFirstEnumName (enum) ; el; 
el = —SomtGetNextEnumName (enum) ) 
for (e2 = —SomtGetFirstEnumName (enum) ; e2 ; 
e2 - —SomtGetNextEnumName (enum) ) 

/* etc. */ 

Parameters 

receiver 

The entry whose next enumerator name is to be retrieved. 



Return Value 

This method returns the next enumerator name for the entry represented by receiver, if it 
has a next enumerator. Otherwise, it returns NULL. 



Example 

To iterate through the enumerator names of an enumeration entry: 

SOMTEnumNameEntryC myEntry; 

printf ("List of enumerator names:\n"); 
for (myEntry = —SomtGetFirstEnumName (enum) ; myEntry; 
myEntry = —SomtGetNextEnumName (enum) ) 
printf ("%s\n" , get_ somtEntryName (myEntry) ) ; 



Related Information 

somtGetFirstEnumName Method 
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SOMTEnumNameEntryC Class 

A SOMTEnumNameEntryC object represents an enumerator name. It provides attributes 
for accessing the enumeration in which it is defined and its value. 

File Stem 

scenumnm 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMTEntryC Class 
SOMObject 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtEnumPtr 

(SOMTEnumEntryC) A pointer to the enumeration that defines this enumerator name. 

somtEnumVal 

(unsigned long) The value of the enumerator. 



New Methods 

None. 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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SOMTMetaClassEntryC Class 

A SOMTMetaClassEntryC object represents the metaclass statement in the 
implementation section of a SOM IDL class interface definition. The actual metaclass is 
represented by a SOMTCIassEntryC object accessed via the somtMetaClassDef attribute. 



File Stem 

scmeta 

Parent 

SOMTEntryC Class 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMTEntryC Class 
SOMObject 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtMetaFile 

(string) The name of the file containing the definition of this metaclass. 

somtMetaClassDef 

(SOMTCIassEntryC) A pointer to an entry object representing the class definition entry 
for this metaclass. 



New Methods 

None. 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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SOMTMethodEntryC Class 

A SOMTMethodEntryC object represents a method declaration within a class interface 
definition. It provides attributes and methods for accessing the method’s type, arguments, 
context, exceptions, and parameters. For overriding methods, it provides attributes for 
accessing the overridden method and the overridden method’s class. 



File Stem 

scmethod 

Base 

SOMTCommonEntryC Class 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMTCommonEntryC 

SOMTEntryC 

SOMObject 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtCReturnType 

(string) The C/C++ return type of the method. 

somtlsVarargs 

(boolean) TRUE if the method definition includes a va_list parameter; FALSE, otherwise. 

somtOriginalMethod 

(SOMTMethodEntryC) For an overriding method definition, the entry for the method 
being overridden. 

somtOriginalClass 

(SOMTCIassEntryC) For an overriding method, the entry for the class whose method 
is being overridden. For a new method, the entry for the class that introduced the 
method. 

somtlsOneway 

(boolean) Whether the method is defined as oneway. 

somtArgCount 

(short) The number of explicit arguments of the method (not including the method’s 
receiver the Environment parameter, or the Context parameter, if any. 

somtContextArray 

(string *) An array of the context string-literals for the method. 
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New Methods 

somtGetFirst<ltem> Methods 
somtGetNext<ltem> Methods 
somtGetIDLParamList Method 
somtGetShortCParamList Method 
somtGetFullCParamList Method 
somtGetShortParamNameList Method 
somtGetFullParamNameList Method 
somtGetNth Parameter Method 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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somtGetFirst</tem> Methods 

These methods get the first exception or parameter for a method entry. 



IDL Syntax 

SOMTStructEntryC somtGetFirstException ( ); 

SOMTParameterEntryC somtGetFirstParameter ( ); 

Note: These methods do not take an Environment parameter. 

Description 

The somtGetFirst</fem> methods return the first exception or parameter for the entry on 
which the method was invoked. Otherwise, it returns NULL. The next item of the same kind 
can be obtained using the corresponding somtGetNext<ltem> Methods. For example, the 
somtGetFirstException method returns the entry representing the first exception of the 
specified method. The somtGetNextException method can be used repeatedly to retrieve 
each successive exception. 

The same somtGetFirst<ltem> and somtGetNext<ltem> methods cannot be used in 
doubly nested loops. For example, the following doubly nested loop will not work, because 
following the first execution of the inner loop, the invocation of somtGetNextException in 
the outer loop will return NULL: 

for (el = _somtGetFirstException (method) ; el; 
el = _somtGetNextException (method) ) 
for (e2 = _somtGetFirstException (method) ; e2 ; 
e2 - _somtGetNextException (method) ) 

/* etc. */ 

Nested loops such as the one above are permissible if the target object of the inner loop 
differs from the target object of the outer loop, or if a different somtGetFirst<ltem> method 
is used in the inner loop. 

For the somtGetFirstParameter method, only explicit method parameters are returned. In 
other words, the method’s receiver, the Environment and the Context parameters are not 
included as parameters. 

Parameters 

receiver 

The method entry whose first item is to be retrieved. 



Return Value 

These methods return the first exception or parameter for a method entry. The type of item 
returned is specific to the method; see the method call syntax shown above. 



Example 

To iterate through the parameters of a method: 

SOMTParameterEntryC myEntry; 
printf ("List of parameters : \n" ) ; 

for (myEntry = _somtGetFirstParameter (method) ; myEntry; 
myEntry = _somtGetNextParameter (method) ) 
printf ("%s\n" , get_somtEntryName (myEntry) ) ; 



Related Information 

somtGetNext<ltem> Methods 
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somtGetFullCParamList Method 

Gets the formal parameter list, including the type and name of each parameter, of a 
method’s C procedure. 



IDL Syntax 

string somtGetFullCParamList (in string buffer, in string varargsParm); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetFullCParamList method returns the formal parameter list for the specified 
method’s C procedure. The list includes both the type and the name of each parameter. 

The parameter list is built in buffer and the address of buffer is returned. The list is delimited 
by newlines rather than commas so that it can be used as a symbol value suitable for list 
substitution in the template. 

This method gives the types of the parameters as they appear in the method’s C 
procedure, which may differ from the IDL types. For example, an out or inout parameter 
may have pointer stars added in the C form. This method includes in the result the 
method’s receiver, the Environment parameter or the Context parameter, if any. 

If the method takes a variable number of arguments, then the vajist parameter is replaced 
by the string specified in varargsParm, unless varargsParm is NULL, in which case the 
vajist parameter is removed. 

Parameters 

receiver 

An object of class SOMTMethodEntryC representing a method entry whose parameter 
list is needed. 

buffer 

The address of a character buffer to receive the argument list. 

varargsParm 

A string representing the variable arguments parameter, or NULL to remove the variable 
arguments parameter. 



Return Value 

The somtGetFullCParamList method returns a string representing the formal argument list 
of the method’s C procedure, including the type and name of each argument. This string is 
stored in buffer. The list is delimited by newlines rather than commas so that it can be used 
as a symbol value suitable for list substitution in the template. 



Example 

char buf [MAX_BUFFER] ; 

SOMTMethodEntryC method; 

SOMTClassEntryC class = get_somtTargetClass (emitter) ; 

SOMTTemplateOutputC template = get_somtTemplate (emitter) ; 

method = _somtGetFirstMethod (class) ; 

_somtGetFullCParamList (method, buf, "va_list ap" ) ; 
_somtSetSymbolCopyBoth (template , "methodFullCParmList" , buf) ; 



Original Class 

SOMTMethod EntryC 
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Related Information 

somtGetFirst<ltem> Methods 
somtGetFullParamNameList Method 
somtGetIDLParamList Method 
somtGetNext<ltem> Methods 
somtGetNth Parameter Method 
somtGetShortCParamList Method 
somtGetShortParamNameList Method 
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somtGetFullParamNameList Method 

Gets the list of parameter names for a method’s procedure. 



IDL Syntax 

string somtGetFullParamNameList (in string buffer, in string varargsParm); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetFullParamNameList method returns a list of parameter names for a specified 
method’s procedure. Unlike the somtGetShortParamNameList, the method’s receiver, the 
Environment and Context parameters, if present, are included in the list. 

The argument list is built in buffer and the address of buffer is returned. The list is delimited 
by newlines rather than commas so that it can be used as a symbol value suitable for list 
substitution in the template. 

If the method takes a variable number of arguments, then the vajist parameter is replaced 
by the string specified by varargsParm. 

Parameters 

receiver 

A SOMTMethodEntryC object representing a method whose parameter names are 
needed. 

buffer 

The address of a buffer in which to build the parameter list. 

varargsParm 

A string representing the variable arguments parameter, or NULL to remove the 
variable arguments parameter. 



Return Value 

A pointer to the string representing the parameter list for the specified method’s procedure. 



Example 

To get the parameter list of a method’s procedure: 

char buf [MAX_BUFFER] ; 

SOMTMethodEntryC method; 

SOMTClassEntryC class = get_somtTargetClass (emitter) ; 

SOMTTemplateOutputC template = get_somtTemplate (emitter) ; 

method = _somtGetFirstMethod (class) ; 

somtGetFullParamNameList (method, buf, "ap"); 
_somtSetSymbolCopyBoth (template , "methodFullParmNameList" , buf) ; 



Original Class 

SOMTMethod EntryC 

Related Information 

somtGetFirst<ltem> Methods 
somtGetFullCParamList Method 
somtGetIDLParamList Method 
somtGetNext<ltem> Methods 
somtGetNth Parameter Method 
somtGetShortCParamList Method 
somtGetShortParamNameList Method 
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somtGetIDLParamList Method 

Gets the formal parameter list, including the type and name of each parameter, of a 
method, in IDL syntax. 



IDL Syntax 

string somtGetIDLParamList (in string buffer); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetIDLParamList method returns the formal parameter list (in IDL form) for the 
specified method. The list includes both the type and the name of each parameter; for 
example, in int x\n in float y\n in char z. The parameter list is built in buffer 
and the address of buffer is returned. The list is delimited by newlines rather than commas 
so that it can be used as a symbol value suitable for list substitution in the template. 

Parameters 

receiver 

An object of class SOMTMethodEntryC representing a method entry whose parameter 
list is needed. 

buffer 

The address of a character buffer to receive the parameter list. 



Return Value 

The somtGetIDLParamList method returns a string representing the formal parameter list 
of the method, including the type and name of each parameter, in IDL syntax. This string is 
stored in buffer. The list is delimited by newlines rather than commas so that it can be used 
as a symbol value suitable for list substitution in the template. 



Example 

char buf [MAX_BUFFER] ; 

SOMTMethodEntryC method; 

SOMTClassEntryC class = get_somtTargetClass (emitter) ; 

SOMTTemplateOutputC template = get_somtTemplate (emitter) ; 

method = _somtGetFirstMethod (class) ; 

_somtGetIDLParamList (method, buf) ; 

_somtSetSymbolCopyBoth (template , "methodIDLParmList" , buf); 



Original Class 

SOMTMethod EntryC 

Related Information 

somtGetFirst<ltem> Methods 
somtGetFullCParamList Method 
somtGetFullParamNameList Method 
somtGetNext<ltem> Methods 
somtGetNth Parameter Method 
somtGetShortCParamList Method 
somtGetShortParamNameList Method 
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somtGetNext</tem> Methods 

These methods get the next exception or parameter for a method entry, relative to the 
previous call for a similar entry. 



IDL Syntax 

SOMTStructEntryC somtGetNextException ( ); 

SOMTParameterEntryC somtGetNextParameter ( ); 

These methods do not take an Environment parameter. 

Description 

The somtGetNext<ltem> methods return the next item for the entry on which the method 
was invoked, if it has a next item of that type. Otherwise, it returns NULL. 

A call to a somtGetNext<ltem> method is relative to the last call of either the same method 
or the corresponding somtGetFirst<ltem> method, applied to the same entry object. This 
implies that the same somtGetFirst<ltem> and somtGetNext<ltem> methods cannot be 
used in doubly nested loops. For example, the following doubly nested loop will not work, 
because following the first execution of the inner loop, the invocation of 
somtGetNextException in the outer loop will return NULL: 

for (el = _somtGetFirstException (method) ; el; 
el = _somtGetNextException (method) ) 
for (e2 = _somtGetFirstException (method) ; e2 ; 
e2 - _somtGetNextException (method) ) 

/* etc. */ 

Nested loops such as the one above are permissible if the target object of the inner loop 
differs from the target object of the outer loop, or if a different somtGetFirst<ltem> method 
is used in the inner loop. 

Note that for the somtGetNextParameter method, only explicit method parameters are 
returned. In other words, the method’s receiver, the Environment and Context parameters 
are not included as parameters. 

Parameters 

receiver 

The method entry whose next item is to be retrieved. 



Return Value 

These methods return the next exception or parameter for the entry on which the method 
was invoked, if it has a next item of that type. Otherwise, it returns NULL. The type of item 
returned is specific to the method; see the method call syntax shown above. 



Example 

To iterate through the parameters of a method: 

SOMTParameterEntryC myEntry; 
printf ("List of parameters : \n" ) ; 

for (myEntry = _somtGetFirstParameter (method) ; myEntry; 
myEntry = _somtGetNextParameter (method) ) 
printf ("%s\n" , get_somtEntryName (myEntry) ) ; 



Related Information 

somtGetFirst<ltem> Methods 
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somtGetNth Parameter Method 

Gets the entry representing a particular parameter of a method. 



IDL Syntax 

SOMTParameterEntryC somtGetNth Parameter (in short n); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetNthParameter method returns the entry object representing the specified 
explicit parameter of the receiver. The first argument is numbered zero. The receiver of the 
method, the Environment and Context parameters, if any, are not returned and are not 
counted. 

Parameters 

receiver 

A SOMTMethodEntryC object representing a method whose parameter is needed. 

n 

The number of the parameter to return, starting from zero. 

Return Value 

The somtGetNthParameter returns the SOMTParameterEntryC object representing the 
nth parameter of receiver. 

Original Class 

SOMTMethod EntryC 

Related Information 

somtGetFirst<ltem> Methods 
somtGetFullCParamList Method 
somtGetFullParamNameList Method 
somtGetIDLParamList Method 
somtGetNext<ltem> Methods 
somtGetShortCParamList Method 
somtGetShortParamNameList Method 
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somtGetShortCParamList Method 

Gets the formal parameter list, including the type and name of each parameter, of a 
method’s C procedure. 



IDL Syntax 

string somtGetShortCParamList (in string buffer, 

in string selfParm, in string varargsParm); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetShortCParamList method returns the formal parameter list for the 
specified method’s C procedure. The list includes both the type and the name of each 
parameter. The parameter list is built in buffer and the address of buffer is returned. The list 
is delimited by newlines rather than commas so that it can be used as a symbol value 
suitable for list substitution in the template. 

This method gives the types of the parameters as they appear in the method’s C 
procedure, which may differ from the IDL types. For example, an out or inout parameter 
may have pointer stars added in the C form. This method does not include in the result the 
method’s receiver, the Environment parameter or the Context parameter, if any. 

If selfParm is not null, then it is added as an initial parameter. The selfParm value can 
contain multiple parameters, delimited by newlines. 

If the method takes a variable number of parameters, then the vajist parameter is replaced 
by the string specified by varargsParm, unless varargsParm is NULL, in which case the 
vajist parameter is removed. 

Parameters 

receiver 

An object of class SOMTMethodEntryC representing a method entry whose parameter 
list is needed. 

buffer 

The address of a character buffer to receive the parameter list. 

selfParm 

A string representing a parameter (or list of newline-separated parameters) to be 
inserted at the start of the list. 

varargsParm 

A string representing the variable arguments parameter, or NULL to remove the 
variable arguments parameter. 



Return Value 

The somtGetShortCParamList method returns a string representing the formal parameter 
list of the method’s C procedure, including the type and name of each parameter. This 
string is stored in buffer. The list is delimited by newlines rather than commas so that it can 
be used as a symbol value suitable for list substitution in the template. 



Example 

char buf [MAX_BUFFER] ; 

SOMTMethodEntryC method; 

SOMTClassEntryC class = get_somtTargetClass (emitter) ; 

SOMTTemplateOutputC template = get_somtTemplate (emitter) ; 

method - _somtGetFirstMethod (class); 
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somtGetShortCParamList Method 



somtGetShortCParamList (method, buf, NULL, "va_list ap" ) ; 
somtSetSymbolCopyBoth (template , "methodShortCParmList" , buf) 



Original Class 

SOMTMethod EntryC 

Related Information 

somtGetFirst<ltem> Methods 
somtGetFullCParamList Method 
somtGetFullParamNameList Method 
somtGetIDLParamList Method 
somtGetNext<ltem> Methods 
somtGetNth Parameter Method 
somtGetShortParamNameList Method 
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somtGetShortParamNameList Method 

Gets the list of explicit parameter names for a method. 



IDL Syntax 

string somtGetShortParamNameList ( in string buffer, 

in string selfParm, in string varargsParm)-, 

Note: This method does not take an Environment parameter. 

Description 

The somtGetShortParamNameList method returns a list of explicit parameter names for a 
specified method. The method’s receiver, the Environment and Context parameters are 
not included in the list; only the explicit method parameters (as declared in IDL) are present 
in the result of this method. 

The parameter list is built in buffer and the address of buffer is returned. The list is delimited 
by newlines rather than commas so that it can be used as a symbol value suitable for list 
substitution in the template. 

If selfParm is not null, then it is added as an initial parameter. The selfParm value can 
contain multiple parameters, delimited by newlines. 

If the method takes a variable number of arguments, then the vajist parameter is replaced 
by the string specified by varargsParm, unless varargsParm is NULL, in which case the 
vajist parameter is removed. 

Parameters 

receiver 

A SOMTMethodEntryC object representing the method whose parameter names are 
needed. 

buffer 

The address of a buffer in which to build the parameter list. 

selfParm 

A string representing a parameter (or list of newline-separated parameters) to be 
inserted at the start of the list. 

varargsParm 

A string representing the variable arguments parameter, or NULL to remove the 
variable arguments parameter. 



Return Value 

The somtGetShortParamNameList returns a pointer to the string representing the 
parameter list for the specified method. 



Example 

To get the parameter list of a method: 

char buf [MAX_BUFFER] ; 

SOMTMethodEntryC method; 

SOMTClassEntryC class = get_somtTargetClass (emitter) ; 

SOMTTemplateOutputC template = get_somtTemplate (emitter) ; 

method = _somtGetFirstMethod (class) ; 

_somtGetShortParamNameList (method, buf, NULL, "ap"); 
_somtSetSymbolCopyBoth (template , "methodShortParmNameList" , buf) ; 
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somtGetShortParamNameList Method 



Original Class 

SOMTMethod EntryC 

Related Information 

somtGetFirst<ltem> Methods 
somtGetFullCParamList Method 
somtGetFullParamNameList Method 
somtGetIDLParamList Method 
somtGetNext<ltem> Methods 
somtGetNth Parameter Method 
somtGetShortCParamList Method 
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SOMTModuleEntryC Class 

A SOMTModuleEntryC object represents an IDL module definition. It provides methods for 
accessing the structs, unions, enums, types, sequences, constants, interfaces and nested 
modules within the module. 



File Stem 

scmodule 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMTEntryC Class 
SOMObject 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtModuleFile 

(string) The name of the file in which the module is defined. 

somtOuterModule 

(SOMTModuleEntryC) The module enclosing this module, or NULL if there is none. 



New Methods 

somtGetFirst<ltem> Methods 
somtGetNext<ltem> Methods 

Overriding Methods 

somDumpSelflnt Method 
somtSetSymbolsOnEntry Method 
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somtGetFirst</tem> Methods 

The somtGetFirst</fein> methods get the first item for a module entry. 



IDL Syntax 

SOMTCIassEntryC somtGetFirstlnterface ( ); 

SOMTModuleEntryC somtGetFirstModule ( ); 

SOMTConstEntryC somtGetFirstModuleConstant ( ); 

SOMTEnumEntryC somtGetFirstModuleEnum ( ); 

SOMTSequenceEntryC somtGetFirstModuleSequence ( ); 

SOMTStructEntryC somtGetFirstModuleStruct ( ); 

SOMTTypedefEntryC somtGetFirstModuleTypedef ( ); 

SOMTUnionEntryC somtGetFirstModuleUnion ( ); 

SOMTEntryC somtGetFirstModuleDef ( ); 

Note: These methods do not take an Environment parameter. 

Description 

The somtGetFirst<ltem> methods return the first item of the type shown above for the 
entry on which the method was invoked; otherwise, it returns NULL. The next item of the 
same kind can be obtained using the corresponding somtGetNext <ltem> method. For 
example, somtGetFirstlnterface returns the entry representing the first interface of the 
specified module. If the module has no interfaces, it returns NULL. somtGetNextlnterface 
can be used repeatedly to retrieve each successive interface. somtGetFirstModuleDef 
returns the first constant/type definition of the module. 

The same somtGetFirst <ltem> and somtGetNext <ltem> cannot be used in doubly nested 
loops. For example, the following doubly nested loop will not work, because following the 
first execution of the inner loop, the invocation of somtGetNextlnterface in the outer loop 
will return NULL: 

for (ml = _somtGetFirstInterf ace (mod) ; ml; 
ml = _somtGetNextInterf ace (mod) ) 
for (m2 = _somtGetFirstInterf ace (mod) ; m2; 
m2 = _somtGetNextInterf ace (mod) ) 

/* etc. */ 

Nested loops such as the one above are permissible if the target object of the inner loop 
differs from the target object of the outer loop, or if a different somtGetFirst <ltem> is used 
in the inner loop. 

Parameters 

receiver 

The entry whose first item is to be retrieved. 



Return Value 

These methods return the first item for a module entry. The type of item returned is specific 
to the method; see the method call syntax shown above. 



Example 

To iterate through the nested modules of a module: 

SOMTModuleEntryC myEntry; 

printf ("List of nested modules : \n" ) ; 
for (myEntry - _somtGetFirstModule (mod) ; myEntry; 
myEntry = _somtGetNextModule (mod) ) 
printf ("%s\n" , get_somtEntryName (myEntry) ) ; 
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somtGetFirst<ltem> Methods 



Related Information 

somtGetNext<ltem> Methods 



Chapter 1 . Emitter Framework 79 




somtGetNext<ltem> Methods 



somtGetNext</tem> Methods 

These methods get the next item for a module entry, relative to the previous call for a 
similar entry. 



IDL Syntax 

SOMTCIassEntryC somtGetNextlnterface ( ); 

SOMTModuleEntryC somtGetNextModule ( ); 

SOMTConstEntryC somtGetNextModuleConstant ( ); 

SOMTEnumEntryC somtGetNextModuleEnum ( ); 

SOMTSequenceEntryC somtGetNextModuleSequence ( ); 

SOMTStructEntryC somtGetNextModuleStruct ( ); 

SOMTTypedefEntryC somtGetNextModuleTypedef ( ); 

SOMTUnionEntryC somtGetNextModuleUnion ( ); 

SOMTEntryC somtGetNextModuleDef ( ); 

Note: These methods do not take an Environment parameter. 

Description 

The somtGetNext <ltem> methods return the next item for the entry on which the method 
was invoked, if it has a next item of that type. Otherwise, it returns NULL. 
somtGetNextModuleDef returns the next constant/type definition of the module. 

A call to a somtGetNext <ltem> is relative to the last call of either the same method or the 
corresponding somtGetFirst <ltem>, applied to the same entry object. This implies that the 
same somtGetFirst <ltem> and somtGetNext <ltem> cannot be used in doubly nested 
loops. For example, the following doubly nested loop will not work, because following the 
first execution of the inner loop, the invocation of somtGetNextlnterface in the outer loop 
will return NULL: 

for (ml = _somtGetFirstInterf ace (mod) ; ml; 
ml - _somtGetNextInterf ace (mod) ) 
for (m2 = _somtGetFirstInterf ace (mod) ; m2; 
m2 = _somtGetNextInterf ace (mod) ) 

/* etc. */ 

Nested loops such as the one above are permissible if the target object of the inner loop 
differs from the target object of the outer loop, or if a different somtGetFirst <ltem> method 
is used in the inner loop. 

Parameters 

receiver 

The entry whose next item is to be retrieved. 



Return Value 

These methods return the next item (of the type shown above) for the entry represented by 
receiver, if it has a next item of that type. Otherwise, it returns NULL. The type of item 
returned is specific to the method; see the method call syntax shown above. 



Example 

To iterate through the nested modules of a module: 

SOMTModuleEntryC myEntry; 

printf ("List of nested modules : \n" ) ; 
for (myEntry = _somtGetFirstModule (mod) ; myEntry; 
myEntry = _somtGetNextModule (mod) ) 
printf ("%s\n" , get_somtEntryName (myEntry) ) ; 
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somtGetNext<ltem> Methods 



Related Information 

somtGetFirst<ltem> Methods 
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SOMTParameterEntryC Class 

A SOMTParameterEntryC object represents a parameter of a method. 

File Stem 

scparm 

Base 

SOMTCommonEntryC Class 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMTCommonEntryC Class 
SOMTEntryC Class 
SOMObject 



Types 

enum somtParameterDirectionT { somtlnE, somtOutE, somtlnOutE } 

Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtParameterDirection 

(somtParameterDirectionT) The I/O direction for the parameter. There are three 
possible parameter directions: 

somtlnE: The parameter is for input. 

somtOutE: The parameter is for output. 

somtlnOutE The parameter is for both input and output 

somtIDLParameterDeclaration 

(string) The IDL declaration of the parameter, including its type and name. 

somtCParameterDeclaration 

(string) The declaration for the parameter within a C/C++ method procedure prototype. 
This may differ from the IDL declaration; in particular, pointer stars may be added, 
depending on the direction of the parameter. 



New Methods 

None. 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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SOMTPassthruEntryC Class 

An object of class SOMTPassthruEntryC represents a passthru item in a class definition. It 
provides attributes for accessing the target, language and body of the passthru, as well as 
whether the passthru is a before or after passthru. 



File Stem 

scpass 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMTEntryC Class 
SOMObject 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtPassthruTarget 

(string) The target emitter for a passthru entry. 

somtPassthru Language 

(string) The name of the language for which a passthru entry is intended. Language 
names are always in upper case. 

somtPassthruBody 

(string) The source text of a passthru entry, without modification. Newlines present in 
the source are retained. 



New Methods 

somtlsBeforePassthru Method 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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somtlsBeforePassthru Method 

Tests whether a passthru entry represents a before or after passthru. 



IDL Syntax 

boolean somtlsBeforePassthru (SOMTPassthruEntryC receiver); 

Note: This method does not take an Environment parameter. 

Description 

The somtlsBeforePassthru method tests whether a passthru entry represents a passthru 
intended to be put at the beginning of the output file or inserted after the #include 
statements, as specified in the .idl file. 

Parameters 

receiver 

An object of class SOMTPassthruEntryC representing a passthru item to be tested. 



Return Value 

The somtlsBeforePassthru method returns TRUE if this passthru entry is a before 
passthru (intended to be put at the beginning of the emitted file), or it returns FALSE if this 
passthru entry is an after passthru (intended to be put after the #include statements in the 
emitted file). 

Original Class 

SOMTPassthruEntryC 

Related Information 

somtEmitFullPassthru Method 
somtGetFirst<ltem> Methods 
somtGetNext<ltem> Methods 
somtEmit<Section> Methods 
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SOMTSequenceEntryC Class 

A SOMTSequenceEntryC object represents a sequence type definition. It provides 
attributes for accessing the type and length of the sequence. 



File Stem 

scseqnce 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMTEntryC Class 
SOMObject 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtSeq Length 

(long) The length of the sequence, as specified in the .idl file. If unspecified, this 
attribute is zero. 

somtSeqType 

(SOMTEntryC) A pointer to an object representing the type of the sequence. 



New Methods 

None. 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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SOMTStringEntryC Class 

A SOMTStringEntryC object represents a string type definition. 

File Stem 

scstring 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass Class 

Ancestor Classes 

SOMTEntryC Class 
SOMObject Class 

Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtString Length 

(long) The length of the string, as specified in the .idl file. If unspecified, this attribute is 
zero. 

New Methods 

None 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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SOMTStructEntryC Class 

A SOMTStructEntryC object represents a struct definition or an exception. Every class 
entry holds a pointer to a struct entry (SOMTStructEntryC object) for each struct defined 
within the class’s interface specification. Each struct entry has attributes that represent the 
class in which the struct was defined (somtStructClass) and whether the struct actually 
represents an exception (somtlsException), and methods for accessing the members of 
the struct. The members of the struct are represented by SOMTTypedefEntryC objects 
whose attributes and methods give the member types and declarator names. 



File Stem 

scstruct 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass Class 

Ancestor Classes 

SOMTEntryC Class 
SOMObject Class 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtStructClass 

(SOMTCIassEntryC) A pointer to an object representing the class in which this struct 
was defined. 

somtlsException 

(boolean) Whether the struct actually represents an exception. 



New Methods 

somtGetFirstMember Method 
somtGetNextMember Method 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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somtGetFirstMember Method 

The somtGetFirstMember method gets the first member for a struct entry. 



IDL Syntax 

SOMTTypedefEntryC somtGetFirstMember ( ); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetFirstMember method returns the first member for the struct entry on which 
the method was invoked. The next member can be obtained using the corresponding 

somtGetNextMember method. 

Note that the somtGetFirstMember and somtGetNextMember methods cannot be used 
in doubly nested loops. For example, the following doubly nested loop will not work, 
because following the first execution of the inner loop, the invocation of 

somtGetNextMember in the outer loop will return NULL: 

for (ml = _somtGetFirstMember (struct) ; ml; 
ml = _somtGetNextMember (struct) ) 
for (m2 = _somtGetFirstMember (struct) ; m2 ; 
m2 = _somtGetNextMember (struct) ) 

/* etc. */ 

Parameters 

receiver 

The struct entry whose first member is to be retrieved. 

Return Value 

This method returns the first member for a struct entry. 

Related Information 

somtGetNextMember Method 
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somtGetNextMember Method 

Get the next member for a struct entry, relative to the previous call for a similar entry. 



IDL Syntax 

SOMTTypedefEntryC somtGetNextMember ( ); 

Note: This method does not take an Environment parameter. 

Description 

The somtGetNextMember method returns the next member for the struct entry on which 
the method was invoked, if it has a next member. Otherwise, it returns NULL. 

A call to a somtGetNextMember method is relative to the last call of either the same 
method or the corresponding somtGetFirstMember method, applied to the same entry 
object. This implies that the somtGetFirstMember and somtGetNextMember methods 
cannot be used in doubly nested loops. For example, the following doubly nested loop will 
not work, because following the first execution of the inner loop, the invocation of 
somtGetNextMember in the outer loop will return NULL: 

for (ml = _somtGetFirstMember (struct) ; ml; 
ml = _somtGetNextMember (struct) ) 
for (m2 = _somtGetFirstMember (struct) ; m2 ; 
m2 = _somtGetNextMember (struct) ) 

/* etc. */ 

Parameters 

receiver 

The struct entry whose next item is to be retrieved. 



Return Value 

This method returns the next member for the struct entry represented by receiver, if it has a 
next member. Otherwise, it returns NULL. 

Related Information 

somtGetFirstMember Method 
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SOMTTemplateOutputC Class 

An object of class SOMTTemplateOutputC represents the output template for an emitter. 
The template controls the format and content of the sections that an emitter emits. The 
emitter itself controls which sections are actually emitted and their order, through its 
implementation of somtGenerateSections Method. The template is initialized from the 
template .efw file. The template consists of a set of section names and corresponding text 
templates containing symbols that, when emitted, are replaced by values appropriate for 
the emitter’s target class/module. For example, the following fragment of a template file 
specifies the format of the class section for a particular emitter: 

: classS 

The class name is <className>. 

Lines that begin with a colon introduce a section. By convention, section names end with S. 
When the SOM Compiler compiles the definition of class Foo and invokes the emitter with 
the above template, the emitter will produce the following text when it emits the class 
section: 



The class name is Foo. 

Lines in a template that begin with a question mark (?) are emitted only if at least one 
symbol appearing on that line is defined with a non-NULL value. In addition to simple 
symbol substitution, two forms of complex substitution are supported: list substitution and 
comment substitution. 

Comment substitution is specified by two dashes before the symbol name. For example, 

<- - methodComment> 

indicates that the value of the symbol methodComment should be emitted in comment 
form. The comment form used depends on the somtCommentStyle and 
somtCommentNewline attributes of the template. 

List substitution is specified by preceding the closing angle bracket. In addition, any 
characters preceding the symbol name indicate the prefix for non-empty lists, and any 
characters after the symbol name and before the indicate the delimiter for list items. For 
example, 

< : methodShortParamNameList , . . . > 

indicates that the items that constitute the value of symbol methodShortParamNameList 
should be emitted with a preceding colon and with a comma and a space between each 
item, as in 

:x, y, z 

Items are delimited in the symbol’s value by newline characters. The somtLineLength 
attribute of the template controls how many list items appear on each line. 

The SOMTTemplateOutputC class provides methods for maintaining the emitter’s symbol 
table. The SOMTTemplateOutputC class defines several general-purpose symbols as well 
as methods through which an emitter can define special-purpose symbols. It provides 
methods whereby an emitter can define and emit special-purpose sections in addition to 
those defined by the SOMTEmitC Class. The general-purpose symbols predefined by the 
SOMTTemplateOutputC class are as follows: 

• attributeDeclarators, attributeBaseType, attributeComment, attributeLineNumber, 
attributeMods 

• attributeDeclarators, attributeBaseType, attributeComment, attributeLineNumber, 
attributeMods 
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• baseMajorVersion, baseMinorVersion, baseSourceFile, baseSourceFileStem, 
baselnclude, baseName, baselDLScopedName, baseCScopedName, baseComment, 
baseLineNumber 

• classMajorVersion, classMinorVersion, classSourceFile, classSourceFileStem, 
classReleaseOrder, classlnclude, className, classComment, classLineNumber, 
classMods, classIDLScopedName, classCScopedName 

• constantName, constantIDLScopedName, constantCScopedName, constantComment, 
constantLineNumber, constantMods, constantType, constantValueUnevaluated, 
constantEvaluated, 

• dataName, datalDLScopedName, dataCScopedName, dataComment, 
dataLineNumber, dataMods, dataType, dataArrayDimensions, dataPointer 

• enumName, enumIDLScopedName, enumCScopedName, enumComment, 
enumLineNumber, enumMods, enumNames 

• metaMajorVersion, metaMinorVersion, metaSourceFile, metaSourceFileStem, 
metalnclude, metaName, metalDLScopedName, metaCScopedName, metaComment, 
metaLineNumber 

• methodName, methodIDLScopedName, methodIDLCScopedName, methodComment, 
methodLineNumber, methodMods, methodType, methodCReturnType, methodContext, 
methodRaises, methodClassName, methodCParamList, methodCParamListVA, 
methodIDLParamList, methodShortParamNameList, methodFullParamNameList 

• moduleName, modulelDLScopedName, moduleCScopedName, moduleComment, 
moduleLineNumber, moduleMods, and timeStamp 

• parameterType, parameterDirection, parameterCDeclaration, 
parameterlDLDeclaration, parameterName, parameterMods, parameterLineNumber, 
parameterComment, parameterlDLScopedName, parameterCScopedName 

• passthruName, passthruComment, passthruLineNumber, passthruMods, 
passthruLanguage, passthruTarget, passthruBody 

• stringLength, sequenceLength 

• structName, structIDLScopedName, structCScopedName, structComment, 
structLineNumber, structMods 

• typedefComment, typedefLineNumber, typedefBaseType, typedefDeclarators 

• unionName, unionIDLScopedName, unionCScopedName, unionComment, 
unionLineNumber, unionMods 

The SOMTTemplateOutputC class also defines the following symbols, which are used by 

the somtEmit<Section> Methods to determine what section names correspond to 

different sections. 

Note: The remainder of the symbols below follow the same convention: 

prologSN, baselncludesPrologSN, baselncludesSN, baselncludesEpilogSN, 
metalncludeSN, classSN, metaSN, basePrologSN, baseSN, baseEpilogSN, 
constantPrologSN, constantSN, constantEpilogSN, typedefPrologSN, typedefSN, 
typedefEpilogSN, structPrologSN, structSN, structEpilogSN, unionPrologSN, 
unionSN, unionEpilogSN, enumPrologSN, enumSN, enumEpilogSN, 
attributePrologSN, attributeSN, attributeEpilogSN, interfacePrologSN, interfaceSN, 
interfaceEpilogSN, modulePrologSN, moduleSN, moduleEpilogSN, 
passthruPrologSN, passthruSN, passthruEpilogSN, releaseSN, dataPrologSN, 
dataSN, dataEpilogSN, methodsPrologSN, methodsSN, overrideMethodsSN, 
overriddenMethodsSN, inheritedMethodsSN, methodsEpilogSN, epilogSN. 
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File Stem 

sctmplt 



Base 

SOMObject 

Metaclass 

SOMCIass 



Ancestor Classes 

SOMObject 

Types 

enum somtCommentStyleT { somtDashesE , somtCPPE, somtCSimpleE , 
somtCBlockE } 

Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtCommentStyle 

(somtCommentStyleT) The style in which comments are emitted, as follows: 
somtDashesE: at the start of each line 

somtCPPE: “//” at the start of each line 

somtCSimpleE: simple C style, each line wrapped in “/*” and “7” 
somtCBlockE: block C style, a leading then a on each line and a final “7 

somtLineLength 

(long) Controls the length of emitted lines, for list output only. The default line length 
72. At least one list item will be output on each line, so making this value very small 
cause list items to be emitted one per line. 

somtCommentNewline 

(boolean) If TRUE, each line of comments that are emitted is preceded by a newline. 



New Methods 

somtGetSymbol Method 
somtSetSymbol Method 
somtSetSymbolCopyName Method 
somtSetSymbolCopyValue Method 
somtSetSymbolCopyBoth Method 
somtCheckSymbol Method 
somtSetOutputFile Method 
somto Method 

somtOutputComment Method 
somtOutputSection Method 
somtAddSectionDefinitions Method 
somtReadSectionDefinitions Method 
somtExpandSymbol Method 

Overriding Methods 

somDefaultlnit Method 
somDestruct Method 
somPrintSelf Method 
somDumpSelflnt Method 
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somtAddSectionDefinitions Method 

Reads section definitions from a string and adds them to a specified template. 



IDL Syntax 

void somtAddSectionDefinitions (in string defString); 

Description 

The somtAddSectionDefinitions method adds the section definitions specified in 
defString to the template represented by receiver. The section definitions in defString must 
be in the following form: 

: sectionl 
value 1 line 1 
value 1 line 2 
: section2 
value 2 line 1 
: section3 
value 3 line 1 

where each line containing a colon (:) in column 1 introduces a new section. The section 
name is the text immediately following the colon. A backslash (\) in column lean be used to 
escape a colon that is not used to start a new section. 

Parameters 

receiver 

An object of class SOMTTemplateOutputC representing a template. 

defString 

A string that specifies the section definitions to add to the template. 



Original Class 

SOMTTemplateOutputC 

Related Information 

somtCheckSymbol Method 
somtExpandSymbol Method 
somtReadSectionDefinitions Method 
somtSetSymbolCopyBoth Method 
somtSetSymbolCopyName Method 
somtSetSymbolCopyValue Method 
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somtCheckSymbol Method 

Checks whether a symbol has been set in a specified template’s symbol table. 

IDL Syntax 

boolean somtCheckSymbol (in string name); 

Description 

The somtCheckSymbol method checks whether the specified symbol has a non-NULL, 
non-zero length value in the template’s symbol table. 

Parameters 

receiver 

An object of class SOMTTemplateOutputC representing a template. 

name 

A string representing the name of the symbol to be tested. 



Return Value 

The somtCheckSymbol method returns TRUE if the indicated symbol has a non-NULL, 
non-zero length value. Otherwise, it returns FALSE. 



Example 

SOMTTemplateOutputC template; 

template = get_somtTemplate (emitter) ; 

if (_somtCheckSymbol (template , "className" ) ) 
printf("The <className> symbol is set . \n" ) ; 



Original Class 

SOMTTemplateOutputC 

Related Information 

somtAddSectionDefinitions Method 
somtExpandSymbol Method 
somtGetSymbol Method 
somtReadSectionDefinitions Method 
somtSetSymbolCopyBoth Method 
somtSetSymbolCopyName Method 
somtSetSymbolCopyValue Method 
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somtExpandSymbol Method 

Expands a section from a template file. 

IDL Syntax 

string somtExpandSymbol ( 

in string s, 
in string but); 

Description 

The somtExpandSymbol method expands a section from a template file, given a symbol 
representing the name of the section, by substituting symbol values for symbol names in 
the template. This expansion can then be assigned as the value of another symbol, using 
one of the somtSetSymbol methods. In this way, the values of emitter symbols can be 
defined declaratively in the template file, rather than procedurally within the emitter’s code. 

Parameters 

receiver 

An object of class SOMTTemplateOutputC representing a template, 
s 

A string representing the name of the section to be expanded. 

but 

A string representing the buffer which will receive the expanded section. 

Return Value 

The somtExpandSymbol method expands the specified section in buf and returns buf. 

Example 

If the template .efw file for an emitter contains the following section definition: 

: methodPref ixS 
<functionpref ix>_ 

then the following code within an overriding implementation of the somtGenerateSections 
Method or any other method of SOMTEmitC will set symbol methodPrefix to be the 
expansion of the methodPrefixS section in the template file (that is, the value of symbol 
functionprefix, if defined by the emitter, followed by an underscore). 

SOMTTemplateOutputC template = get_somtTemplate (emitter) ; 

char buf [MAX_SYMBOL_SIZE] ; 

_somtSetSymbolCopyBoth (template , "methodPrefix" , 

_somtExpandSymbol ( 

template, "methodPrefixS", buf)) 

Original Class 

SOMTTemplateOutputC 
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Related Information 

somtAddSectionDefinitions Method 
somtReadSectionDefinitions Method 
somtCheckSymbol Method 
somtGetSymbol Method 
somtSetSymbol Method 
somtSetSymbolCopyBoth Method 
somtSetSymbolCopyValue Method 
somtSetSymbolCopyName Method 
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somtGetSymbol Method 

Gets a symbol value from a template’s symbol table. 



IDL Syntax 

string somtGetSymbol (in string name); 

Description 

The somtGetSymbol method gets the value of symbol name from the symbol table of the 
template object on which the method was invoked. 

Parameters 

receiver 

An object of class SOMTTemplateOutputC representing a template. 

name 

A string representing the name of the symbol whose value is needed. 



Return Value 

The somtGetSymbol method returns the string representing the value of the symbol. If 
there is no associated value, then somtGetSymbol returns NULL. 



Example 

To set the symbol prefix to the value of externaiPref ix (if that symbol has already 
been given a value): 

SOMTTemplateOutputC template = get_somtTemplate (emitter) ; 

_somtSetSymbolCopyName (template, "prefix" , 

_somtGetSymbol (template, "externaiPref ix" ) ) ; 



Original Class 

SOMTTemplateOutputC 

Related Information 

somtCheckSymbol Method 
somtExpandSymbol Method 
somtSetSymbolCopyBoth Method 
somtSetSymbolCopyName Method 
somtSetSymbolCopyValue Method 
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somto Method 

Outputs a template to a file. 



IDL Syntax 

void somto (in string tmplt); 

Description 

The somto method outputs a template tmplt after substituting for any symbols that occur in 

it. (This method is usually not called directly.) Five kinds of symbol substitutions are 

supported: simple, list, comment, tab, and conditional. 

Substitutable items in the template are bracketed with angle brackets (< >). The backslash 

(\) can be used to escape an angle bracket. 

• Simple substitution replaces a symbol with its value. If the symbol has no value in the 
symbol table of the SOMTTemplateOutputC object on which the method was invoked, 
then the symbol is replaced by the string symbol < . . . > is not defined. 

• List substitution replaces a symbol with a value expressed in list form, using specified 
delimiters. The symbol value must consist of a sequence of list items, separated by 
newline characters. The list-substitution specification consists of four parts: a prefix, the 
symbol, a separator, and a list indicator. The prefix and separator components can only 
be composed of blanks, commas, colons and semicolons. The list indicator is . .” 
(three periods). For example, the list-substitution specification < , name , . . . > has a 
prefix of ”, a symbol of name and a separator of ”. The prefix will precede the list 
whenever there is at least one item in the list, and the separator will be used between 
any two list items. After each item of the list is output, the next item is evaluated to 
determine whether it would exceed the maximum line length (set by the receiver’s 
attribute somtLineLength). If it would, then a new line is begun and the next value is 
placed directly under the first item. 

• Comment substitution replaces a symbol with its value in the form of a comment. A 
comment specification consists of the two characters -” followed by a symbol name. 
For example, <- - classComment> is a valid comment-substitution specification. 

The lines of the comment are output according to the somtCommentStyle attribute of 
the receiver, and are aligned with the starting column of the comment specification. 

• Tab substitution is specified by <@dd>, where dd is a valid positive integer representing 
a column number. Blanks will be inserted into the output stream if necessary to position 
the next character of output at the column indicated by dd. 

• Conditional substitution is specified by putting a question mark (?) in column one of the 
template line. The line will not be output unless at least one valid, non-blank symbol 
substitution occurs on the line. 

Parameters 

receiver 

An object of class SOMTTemplateOutputC representing an emitter’s template. 

tmplt 

A string representing the template to be output. 
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somtOutputComment Method 

Inserts a comment into the output file. 



IDL Syntax 

void somtOutputComment (in string comment); 

Description 

The somtOutputComment method inserts a comment into the output file. The specified 
comment must be a string in which each comment line terminates with a newline character. 

Parameters 

receiver 

An object of class SOMTTemplateOutputC representing a template. 

comment 

A string representing the comment to be emitted. 

Example 

SOMTTemplateOutputC template = get_somtTemplate (emitter) ; 

_somtOutputComment (template , "Here is a comment to emit."); 

Original Class 

SOMTTemplateOutputC 

Related Information 

somto Method 
somtOutputSection Method 
somtSetOutputFile Method 
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somtOutputSection Method 

Outputs a section of a template. 



IDL Syntax 

void somtOutputSection (in string sectionName); 

Description 

The somtOutputSection method outputs the section named by sectionName after 
substituting for any symbols in that section. The template .efw file defines each section. 

Five types of symbol substitution are supported: simple, list, comment, tab and conditional. 

Substitutable items in a template are bracketed with angle brackets (<>). The backslash (\) 
can be used to escape an angle bracket. 

• Simple substitution replaces a symbol with its value. If the symbol has no value for the 
SOMTTemplateOutputC object, then the symbol is replaced by the string symbol 
<...> is not defined. 

• List substitution replaces a symbol with a value expressed in list form, using specified 
delimiters. The symbol value must consist of a sequence of list items, separated by 
newline characters. The list-substitution specification consists of four parts: a prefix, the 
symbol, a separator and a list indicator 

The prefix and separator components can only be composed of blanks, commas, 
colons and semicolons. The list indicator is the periods (. . .). For example, the list- 
substitution specification <, name, ...> has a prefix of “, ”, a symbol of name and a 
separator of “, ”. The prefix will precede the list whenever there is at least one item in 
the list, and the separator will be used between any two list items. After each item of 
the list is output, the next item is evaluated to determine whether it would exceed the 
maximum line length (set by the receiver’s attribute somtLineLength). If it would, then 
a new line is begun and the next value is placed directly under the first item. 

• Comment substitution replaces a symbol with its value in the form of a comment. A 
comment specification consists of the two characters “- -” followed by a symbol name. 
For example, <- - classComment> is a valid comment-substitution specification. 

The lines of the comment are output according to the somtCommentStyle attribute of 
the receiver, and are aligned with the starting column of the comment specification. 

• Tab substitution is specified by <@dd>, where dd is a valid positive integer representing 
a column number. Blanks will be inserted into the output stream if necessary to position 
the next character of output at the column indicated by dd. 

• Conditional substitution is specified by putting a question mark (?) in column one of the 
template line. The line will not be output unless at least one valid, non-blank symbol 
substitution occurs on the line. 

Parameters 

receiver 

An object of class SOMTTemplateOutputC representing a template. 

sectionName 

A string representing the name of the section to be emitted. 



Example 

SOMTTemplateOutputC template = get_somtTemplate (emitter) ; 

_somtOutputSection (template , "metaSectionS") ; 
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Original Class 

SOMTTemplateOutputC 

Related Information 

somtAddSectionDefinitions Method 
somto Method 

somtReadSectionDefinitions Method 
somtSetOutputFile Method 
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somtReadSectionDefinitions Method 

Reads section definitions from a file and adds them to the specified template. 



IDL Syntax 

void somtReadSectionDefinitions (inout FILE *fp); 

Description 

The somtReadSectionDefinitions method reads all section definitions from the file 
specified by fp and adds them to the template on which the method was invoked. Section 
definitions must be in the following form: 

: sectionl 
value 1 line 1 
value 1 line 2 
: section2 
value 2 line 1 
: section3 
value 3 line 1 

where each line containing a colon (:) in column 1 introduces a new section. The section 
name is the text immediately following the colon. A backslash (\) in column lean be used to 
escape a colon that is not used to start a new section. 

Parameter 

receiver 

An object of class SOMTTemplateOutputC representing the template to which the 
section definitions will be added. 

fp 

A pointer to the file containing the section definitions. 

Example 

To read the section definitions from the myfile.efw template file: 

MyEmitter emitter; 

SOMTTemplateOutputC template; 

emitter = MyEmitterNew ( ) ; 

template = get_somtTemplate (emitter) ; 

if (deffile = _somtOpenSymbolsFile (emitter , "myfile.efw", "r")) 

_somtReadSectionDef initions (template , deffile) ; 



Original Class 

SOMTTemplateOutputC 

Related Information 

somtAddSectionDefinitions Method 
somto Method 

somtOpenSymboIsFile Method 
somtOutputSection Method 
somtSetOutputFile Method 
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somtSetOutputFile Method 

Sets the output file for an emitter. 



IDL Syntax 

void somtSetOutputFile (inout FILE *fp); 

Description 

The somtSetOutputFile method specifies the file to which all output will be directed. This 
method usually need not be invoked directly, because a template’s output file is set when 
its emitter’s target file is set (using _set_somtTargetFile). The default output file is stdout. 

Parameters 

receiver 

An object of class SOMTTemplateOutputC representing the template of the emitter. 

fp 

A pointer to the output file. 

Original Class 

SOMTTemplateOutputC 

Related Information 

somto Method 
somtOutputSection Method 
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somtSetSymbol Method 

Sets a symbol to a given value in the symbol table of a specified template. 



IDL Syntax 

void somtSetSymbol (in string name, in string value); 

Description 

The somtSetSymbol method sets a symbol name to a specified value in the symbol table 
of the template object on which the method was invoked. This adds the name value pair to 
the symbol table or overwrites a previous setting, if necessary. 

The symbol table assumes ownership of both the name and value, and these strings must 
not be freed by the caller. If the value of the named symbol is changed by subsequent calls 
to a somtSetSymbol method, then the string passed as the value parameter will be freed 
by the symbol table. Hence, if the string representing the value is a static string or a string 
that will be freed by the caller, or if the symbol value may change during subsequent 
execution of the emitter and it is necessary that the string passed as the value parameter 
not be freed by the symbol table, then you should use the somtSetSymbolCopyValue or 
somtSetSymbolCopyBoth method to define the name/value pair. Likewise, if the string 
representing the name is a static string or a string that will be freed by the caller, you should 
use the somtSetSymbolCopyName or somtSetSymbolCopyBoth method to define the 
name/value pair. 

Parameters 

receiver 

An object of class SOMTTemplateOutputC, representing the template object of an 
emitter. 

name 

A string representing a symbol name. 

value 

A string representing a symbol value. 

Original Class 

SOMTTemplateOutputC 

Related Information 

somtCheckSymbol Method 
somtExpandSymbol Method 
somtGetSymbol Method 
somtSetSymbol Method 
somtSetSymbolCopyBoth Method 
somtSetSymbolCopyName Method 
somtSetSymbolCopyValue Method 
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somtSetSymbolCopyBoth Method 

Sets a symbol to a given value in the symbol table of a specified template, using copies of 
the original name and value. 



IDL Syntax 

void somtSetSymbolCopyBoth (in string name, in string value); 

Description 

The somtSetSymbolCopyBoth method sets a symbol name to a specified value in the 
symbol table of the template object on which the method is invoked. This adds the name/ 
value pair to the symbol table or overwrites a previous setting, if necessary. 

The somtSetSymbolCopyBoth method makes a copy of both the name and value 
parameters; it stores in the symbol table and takes ownership of the copies, rather than the 
original strings. This method is appropriate when the caller wants to maintain ownership of 
the strings representing both name and value, or when the name and value are static 
strings. Because the method makes a copy of value before storing it in the symbol table, if 
the value of the symbol is subsequently changed, only the symbol table’s copy of the 
original value will be freed, and not the string passed by the caller. 

Parameters 

receiver 

An object of class SOMTTemplateOutputC representing the template object of an 
emitter. 

name 

A string representing a symbol name. 

value 

A string representing a symbol value. 

Example 

To set the symbol newMethodLabel to the value New Sections: 

SOMTTemplateOutputC t = get_somtTemplate (emitter) ; 

_somtSetSymbolCopyBoth (t , "newMethodLabel" , "New Sections") ; 

Original Class 

SOMTTemplateOutputC 

Related Information 

somtCheckSymbol Method 
somtExpandSymbol Method 
somtGetSymbol Method 
somtSetSymbol Method 
somtSetSymbolCopyName Method 
somtSetSymbolCopyValue Method 
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somtSetSymbolCopyName Method 

Sets a symbol to a given value in the symbol table of a specified template, using a copy of 
the original name. 



IDL Syntax 

void somtSetSymbolCopyName (in string name, in string value); 

Description 

The somtSetSymbolCopyName method sets a symbol name to a specified value in the 
symbol table of the template object on which the method is invoked. This adds the name/ 
value pair to the symbol table or overwrites a previous setting, if necessary. 

somtSetSymbolCopyName makes a copy of the name parameter, but not the value 
parameter, before storing the pair in the symbol table. Use this method when you wants to 
maintain ownership of the string or when the name is a static string. 

After execution of somtSetSymbolCopyName, the symbol table assumes ownership of 
the string passed as the value parameter. Hence, this string must not be freed by the caller, 
and it should not be a static string. If the value of the named symbol is changed by 
subsequent calls to a somtSetSymbol, then the string passed as the value parameter will 
be freed by the symbol table. If the string representing the value is a static string or a string 
that will be freed by the caller, or if the symbol value may change during subsequent 
execution of the emitter and it is necessary that the string passed as the value parameter 
not be freed by the symbol table, then you should use somtSetSymbolCopyBoth to define 
the name/value pair. 

Parameters 

receiver 

An object of class SOMTTemplateOutputC representing the template object of an 
emitter. 

name 

A string representing a symbol name. 

value 

A string representing a symbol value. 

Example 

To set the baseNames variable to the value returned by a function buildbaseNames that 
returns ownership of the string it produces to the caller: 

SOMTClassEntryC els = get_somtTargetClass (emitter) ; 

SOMTTemplateOutputC t = get_somtTemplate (emitter) ; 

_somtSetSymbolCopyName (t, "baseNames" , buildbaseNames (els) ) ; 

Original Class 

SOMTTemplateOutputC 

Related Information 

somtCheckSymbol Method 
somtExpandSymbol Method 
somtGetSymbol Method 
somtSetSymbol Method 
somtSetSymbolCopyBoth Method 
somtSetSymbolCopyValue Method 
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somtSetSymbolCopyValue Method 

Sets a symbol to a given value in the symbol table of a template object, using a copy of the 
original value. 



IDL Syntax 

void somtSetSymbolCopyValue (in string name, in string value); 

Description 

The somtSetSymbolCopyValue method sets a symbol name to a specified value in the 
symbol table of the template object on which the method is invoked. This adds the name/ 
value pair to the symbol table or overwrites a previous setting, if necessary. 

somtSetSymbolCopyValue makes a copy of the value parameter, but not the name 
parameter, before storing the name/value pair in the symbol table. Use this method when 
you wants to maintain ownership of the string representing the symbol value or when the 
value is a static string. Because the method makes a copy of the value before storing it in 
the symbol table, if the value of the symbol is changed, only the symbol table’s copy of the 
original value will be freed, and not the string passed by the caller. 

After execution of this method, the symbol table assumes ownership of the string passed as 
the name parameter. Hence, this string must not be freed by the caller, and it should not be 
a static string. 

Parameters 

receiver 

An object of class SOMTTemplateOutputC representing the template object of an 
emitter. 

name 

A string representing the symbol name. 

value 

A string representing the symbol value. 

Example 

To change the default value of the className symbol so that it begins with an underscore: 

char * s ; 

SOMTTemplateOutputC t = get_somtTemplate (emitter) ; 

char buf [MAX_SMALL_STRING] ; 

s = _somtGetSymbol ( t , "className"); 
if (s ScSc *s) 

{ sprintf (buf , "_%s" , s) ; 

somtSetSymbolCopyValue ( t , "className", buf);} 

Original Class 

SOMTTemplateOutputC 

Related Information 

somtCheckSymbol Method 
somtExpandSymbol Method 
somtGetSymbol Method 
somtSetSymbol Method 
somtSetSymbolCopyBoth Method 
somtSetSymbolCopyName Method 
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SOMTTypedefEntryC Class 

A SOMTTypedefEntryC object represents a typedef within a class definition or a member 
of a user-defined struct. Each typedef entry has an attribute representing the base type 
(somtTypedefType) of the new type(s) and methods for accessing the declarator names of 
the typedef. If the type of a typedef is a user-defined type, then the somtTypedefType 
attribute will be a pointer to an instance of SOMTUserDefinedTypeEntryC . The 
somtOriginalTypedef attribute of that object will point to a SOMTTypedefEntryC object 
that represents the typedef for that user-defined type. 

For example, if the following appears in an IDL specification: 

typedef long mytypel; 
typedef mytypel mytype2 ; 

the SOMTTypedefEntryC object that represents the typedef of mytype2 would have a 
somtTypedefType attribute whose value is an object of type 

SOMTUserDefinedTypeEntryC. That object’s somtOriginalTypedef attribute would point 
to a somtTypedefEntryC object that represents the typedef of mytypel. 

Because a single typedef may have several declarators (that introduce several user-defined 
types), the somtTypedefType attribute of a typedef gives only the base type of the 
user-defined types; to get the full type, users should access each declarator in turn and get 
its somtType attribute. 

File Stem 

sctdef 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMTEntryC Class 
SOMObject 

Attributes 

Listed below is the attribute, with its corresponding type in parentheses, followed by a 
description of its purpose: 

somtT ypedefT ype 

(SOMTEntryC) A pointer to an entry object representing the base type of the typedef. 
This doesn’t include pointer stars or array declarators; to get the full type, get each of 
the declarators (using somtGetFirstDeclarator and somtGetNextDeclarator) and get 
its somtType attribute. 



New Methods 

somtGetFirstDeclarator Method 
somtGetNextDeclarator Method 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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somtGetFirstDeclarator Method 

The somtGetFirstDeclarator method gets the first declarator for a typedef entry. 



IDL Syntax 

SOMTCommonEntryC somtGetFirstDeclarator ( ); 

Description 

The somtGetFirstDeclarator method returns the first declarator for the typedef entry on 
which the method was invoked. The next declarator can be obtained using the 
corresponding somtGetNextDeclarator method. 

The somtGetFirstDeclarator and somtGetNextDeclarator methods cannot be used in 
doubly nested loops. For example, the following doubly nested loop will not work, because 
following the first execution of the inner loop, the invocation of somtGetNextDeclarator in 
the outer loop will return NULL: 

for (dl = _somtGetFirstDeclarator (myTypedef ) ; dl ; 
dl = _somtGetNextDeclarator (myTypedef ) ) 
for (d2 = _somtGetFirstDeclarator (myTypedef ) ; d2 ; 
d2 = _somtGetNextDeclarator (myTypedef ) ) 

/* etc. */ 

Parameters 

receiver 

The typedef entry whose first declarator is to be retrieved. 



Return Value 

This method returns the first declarator for a typedef entry. 



Example 

To iterate through the declarators of a typedef: 

SOMTCommonEntryC myEntry; 
printf ( "List of declarators : \n" ) ; 

for (myEntry = _somtGetFirstDeclarator (myTypedef ) ; myEntry; 
myEntry = _somtGetNextDeclarator (myTypedef ) ) 
printf ("%s\n" , get_somtEntryName (myEntry) ) ; 



Related Information 

somtGetNextDeclarator Method 
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somtGetNextDeclarator Method 

This method gets the next declarator for a typedef entry, relative to the previous call for a 
similar entry. 



IDL Syntax 

SOMTCommonEntryC somtGetNextDeclarator ( ); 

Description 

The somtGetNextDeclarator method returns the next declarator for the typedef entry on 
which the method was invoked, if it has a next declarator. Otherwise, it returns NULL. 

A call to a somtGetNextDeclarator method is relative to the last call of either the same 
method or the corresponding somtGetFirstDeclarator method, applied to the same entry 
object. Note that this implies that the somtGetFirstDeclarator and 
somtGetNextDeclarator methods cannot be used in doubly nested loops. For example, 
the following doubly nested loop will not work, because following the first execution of the 
inner loop, the invocation of somtGetNextDeclarator in the outer loop will return NULL: 

for (dl = _somtGetFirstDeclarator (myTypedef ) ; dl ; 
dl = —SomtGetNextDeclarator (myTypedef ) ) 
for (d2 = —SomtGetFirstDeclarator (myTypedef ) ; d2 ; 
d2 = —SomtGetNextDeclarator (myTypedef ) ) 

/* etc. */ 

Parameters 

receiver 

The entry whose next item is to be retrieved. 



Return Value 

This method returns the next declarator for the typedef entry represented by receiver, if it 
has a next item of that type. Otherwise, it returns NULL. 



Example 

To iterate through the declarators of a typedef: 

SOMTCommonEntryC myEntry; 
printf("List of declarators : \n" ) ; 

for (myEntry = —SomtGetFirstDeclarator (myTypedef ) ; myEntry; 
myEntry = —SomtGetNextDeclarator (myTypedef ) ) 
printf ("%s\n" , get_ somtEntryName (myEntry) ) ; 



Related Information 

somtGetFirstDeclarator Method 
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SOMTUnionEntryC Class 

A SOMTUnionEntryC object represents a union definition. It provides attributes and 
methods for accessing the union’s switch type and each of its cases. 

File Stem 

scunion 

Base 

SOMTEntryC Class 

Metaclass 

SOMCIass 

Ancestor Classes 

SOMTEntryC Class 
SOMObject 



Types 

struct somtLabelList { 
string label; 
somtLabelList *nextLabel; 

}; 

struct somtCaseEntry { 

somtLabelList *caseLabels; 

SOMTEntryC memberType; 

SOMTDataEntryC memberDeclarator ; 

} ; 

Attributes 

Listed below is the available attribute, with its corresponding type in parentheses, followed 
by a description of its purpose: 

somtSwitchType 

(SOMTEntryC) A pointer to an entry object representing the switch type of the union. 



New Methods 

somtGetFirstCaseEntry Method 
somtGetNextCaseEntry Method 

Overriding Methods 

somtSetSymbolsOnEntry Method 
somDumpSelflnt Method 
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somtGetFirstCaseEntry Method 

[The somtGetFirstCaseEntry method gets the first case for a union entry. 



IDL Syntax 

somtCaseEntry * somtGetFirstCaseEntry ( ); 

Description 

The somtGetFirstCaseEntry method returns the first case for the union entry on which the 
method was invoked. The next case can be obtained using the corresponding 

somtGetNextCaseEntry method. 

The somtGetFirstCaseEntry and somtGetNextCaseEntry methods cannot be used in 
doubly nested loops. For example, the following doubly nested loop will not work, because 
following the first execution of the inner loop, the invocation of somtGetNextCaseEntry in 
the outer loop will return NULL: 

for (cl = _somtGetFirstCaseEntry (myUnion) ; cl; 
cl = _somtGetNextCaseEntry (myUnion) ) 
for (c2 = _somtGetFirstCaseEntry (myUnion) ; c2 ; 
c2 = _somtGetNextCaseEntry (myUnion) ) 

/* etc. */ 

Parameters 

receiver 

The union entry whose first case is to be retrieved. 



Return Value 

This method returns the first case for a union entry. The somtGetFirstCaseEntry method 
returns a pointer to a somtCaseEntry struct; see the reference page for the 

SOMTUnionEntryC class for the definition of somtCaseEntry. 



Example 

To iterate through the cases of a union: 

SOMTCaseEntry *case; 
printf ( "List of cases : \n" ) ; 

for (case = _somtGetFirstCaseEntry (myUnion) ; case; 
case = _somtGetNextCaseEntry (myUnion) ) 

printf ("%s\n" , get_somtEntryName 

(case- >memberDeclarator) ) ; 

Related Information 

somtGetNextCaseEntry Method 
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somtGetNextCaseEntry Method 

The somtGetNextCaseEntry method gets the next case for a union entry. 

IDL Syntax 

somtCaseEntry * somtGetNextCaseEntry ( ); 

Description 

The somtGetNextCaseEntry method returns the next case for the union entry on which 
the method was invoked, if it has a next case. Otherwise, it returns NULL. 

A call to a somtGetNextCaseEntry method is relative to the last call of either the same 
method or the corresponding somtGetFirstCaseEntry method, applied to the same entry 
object. Note that this implies that the somtGetFirstCaseEntry and 
somtGetNextCaseEntry methods cannot be used in doubly nested loops. For example, 
the following doubly nested loop will not work, because following the first execution of the 
inner loop, the invocation of somtGetNextCaseEntry in the outer loop will return NULL: 

for (cl = _somtGetFirstCaseEntry (myUnion) ; cl; 
cl = _somtGetNextCaseEntry (myUnion) ) 
for (c2 = _somtGetFirstCaseEntry (myUnion) ; c2 ; 
c2 = _somtGetNextCaseEntry (myUnion) ) 

/* etc. */ 

Parameters 

receiver 

The union entry whose next case is to be retrieved. 

Return Value 

This method returns the next case for a union entry. The somtGetNextCaseEntry method 
returns a pointer to a somtCaseEntry struct; see the reference page for the 

SOMTUnionEntryC class for the definition of somtCaseEntry. 

Example 

To iterate through the cases of a union: 

SOMTCaseEntry *case; 
printf ( "List of cases : \n" ) ; 

for (case = _somtGetFirstCaseEntry (myUnion) ; case; 
case = _somtGetNextCaseEntry (myUnion) ) 

printf ("%s\n" , get_somtEntryName 

(case- >memberDeclarator) ) ; 

Related Information 

somtGetFirstCaseEntry Method 
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SOMTUserDefinedTypeEntryC Class 

A SOMTUserDefinedTypeEntryC object represents a type defined via a typedef statement 
in a .idl file. 



File Stem 



scusrtyp 



Base 

SOMTEntryC Class 

Metaclass 

SOMCIass 



Ancestor Classes 

SOMTEntryC Class 
SOMObject 



Attributes 

Listed below is each available attribute, with its corresponding type in parentheses, 
followed by a description of its purpose: 

somtOriginalTypedef 

(SOMTTypedefEntryC) A pointer to the object representing the typedef that defines 
the user-defined type. 

somtBaseTypeObj 

(SOMTEntryC) A pointer to the object representing the base type of the user-defined 
type, regardless of any intermediate user-defined types. For example, given: 

typedef short x; 
typedef x y; 

The base type of user-defined type “y” is “short.” 

New Methods 

None. 



Overriding Methods 

somDumpSelflnt Method 
somtSetSymbolsOnEntry Method 
getsomtT y peObj 
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somterror Function 

Prints an error message and increments the error count maintained by the SOM Compiler. 

Syntax 

void somterror (string file, long lineno, string format, ...); 

Description 

The somterror function prints an error message and increments the error count maintained 
by the SOM Compiler. The error message begins with the string “error: ” and includes the 
name of the file and the line number on which the error occurred, if specified. 

Parameters 

file 

The name of the file in which the error occurred, or NULL. 

lineno 

The line number on which the error occurred, or zero. 

format 

A format string suitable for passing to the printf C library function. 

varargs 

The arguments to be passed to printf. 

Example 

somterror ( get_somtSourceFileName (els) , 

get_somtSourceLineNumber (entry) , 

"I don't understand the entry named %s.\n", 

get_somtEntryNae (entry) ) ; 

Related Information 

somtfatal Function 
somtinternal Function 
somtmsg Function 
somtwarn Function 
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somtfatal Function 

Prints a fatal error message and increments the internal error count maintained by the SOM 
Compiler. 



Syntax 

void somtfatal (string file, long lineno, string format, ...); 

Description 

The somtfatal function prints a fatal error message and increments the internal error count 
maintained by the SOM Compiler. The error message begins with the string “fatal error: ” 
and includes the name of the file and the line number on which the error occurred, if 
specified. After printing the error message, the routine removes the output file and 
terminates the process. 

Parameters 

file 

The name of the file in which the error occurred, or NULL. 

lineno 

The line number on which the error occurred, or zero. 

format 

A format string suitable for passing to the printf C library function. 

varargs 

he arguments to be passed to printf. 



Example 

somtfatal ( get_somtSourceFileName (els) , 

get_somtSourceLineNumber (entry) , 

"The entry named %s is a disaster !. \n" , 
get_somtEntryName (entry) ) ; 



Related Information 

somterror Function 
somtinternal Function 
somtmsg Function 
somtwarn Function 
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somtfclose Function 

Closes a file opened using somtOpenEmitFile. 



Syntax 

int somtfclose (FILE *fp); 

Description 

The somtfclose function closes a file opened using somtopenEmitFile. Emitters that use 
somtOpenEmitFile should use this function, rather than fclose, to close the output file so 
that, regardless of the way the standard C library is packaged or whether emitters are 
statically or dynamically loaded, files opened with somtopenEmitFile will be properly 
closed. Emitters are not required to close their output files; normally, an emitter’s return 
value is the file handle for the file it opened using somtopenEmitFile. If an emitter needs 
to close its output file, however, the somtfclose function should be used, rather than 
fclose. 

Parameters 

fp 

A pointer to the file to be closed. 

Return Value 

The somtfclose returns the same return code as the C library fclose function. 

Example 

FILE *fp * somtopenEmitFile ( "hello . foo" , "foo"); 

set_somtTargetFile (emitter , fp) ; 

somtfclose ( fp) ; 

Related Information 

somtopenEmitFile Function 
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somtGetObjectWrapper Function 

Gets the entry object corresponding to the els argument passed by the SOM Compiler to an 
emitter’s driver program. This object should then be set as the target class or module of the 
emitter. 



Syntax 

SOMTEntryC somtGetObjectWrapper (Entry *entry); 

Description 

The somtGetObjectWrapper function gets the entry object corresponding to the els 
argument passed by the SOM Compiler to an emitter’s driver program. This object should 
then be set as the target class or module of the emitter. Before freeing the emitter object, 
the object returned by this function should be freed. 

Parameters 

entry 

The data structure passed by the SOM Compiler to an emitter’s driver program. 

Return Value 

The somtGetObjectWrapper function returns the entry object created. 



Example 

SOMTClassEntryC oCls; 

SOMTModuleEntryC mod; 

MyEmitter emitter; 

if (cls->type == SOMTClassE) { 

oCls = (SOMTClassEntryC) somtGetObjectWrapper (els) ; 
emitter = MyEmitterNew ( ) ; 

set_somtTargetClass (emitter , oCls) ; 

i" 

else if (cls->type == SOMTModuleE) { 

mod = (SOMTModuleEntryC) somtGetObjectWrapper (els) ; 
emitter = MyEmitterNew () ; 

set_somtTargetModule (emitter , mod) ; 

i" 
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somtinternal Function 

Prints an internal error message and increments the internal error count maintained by the 
SOM Compiler. 

Syntax 

void somtinternal (string file, long lineno, string format, ...); 

Description 

The somtinternal function prints an internal error message and increments the internal 
error count maintained by the SOM Compiler. The error message begins with the string 
“internal error: ” and includes the name of the file and the line number on which the error 
occurred, if specified. After printing the error message, the routine removes the output file 
and terminates the process. 

Parameters 

file 

The name of the file in which the error occurred, or NULL. 

lineno 

he line number on which the error occurred, or zero. 

format 

A format string suitable for passing to the printf C library function. 

varargs 

The arguments to be passed to printf. 

Example 

somtinternal ( get_somtSourceFileName (els) , 

get_somtSourceLineNumber (entry) , 

"I really messed this one up ! \n" ) ; 

Related Information 

somterror Function 
somtfatal Function 
somtmsg Function 
somtwarn Function 
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somtmsg Function 

Prints an informational message. 



Syntax 

void somtmsg (string file, long lineno, string format, ...); 

Description 

The somtmsg function prints an informational message. The message includes the name 
of the file and the line number to which the message applies, if specified. 

In order for a somtmsg function to produce output, you also must specify the -v (verbose) 
flag when entering the sc command on the command line to invoke the SOM Compiler. 
See Running the SOM Compiler on page 1 61 in Programmer’s Guide for SOM and 
DSOM. 

Parameters 

file 

The name of the file to which the message applies, or NULL. 

lineno 

The line number to which the message applies, or zero. 

format 

A format string suitable for passing to the printf C library function. 

varargs 

The arguments to be passed to printf. 

Example 

somtmsg ( get_somtSourceFileName (els) , 

get_somtSourceLineNumber (entry) , 

"I really like the entry named %s.\n", 

get_somtEntryName (entry) ) ; 

Related Information 

somterror Function 
somtwarn Function 
somtfatal Function 
somtinternal Function 
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somtNewSymbol Function 

Creates a new symbol name by concatenating a prefix and a name. 



Syntax 

string somtNewSymbol (string prefix, string stem); 

Description 

The somtNewSymbol function creates a new symbol name by concatenating a prefix and 
a name. Ownership of the string is passed to the caller. Hence, the somtSetSymbol or 
somtSetSymbolCopyValue method should be used to give the resulting symbol a value, 
instead of somtSetSymbolCopyName or somtSetSymbolCopyBoth. This function is 
useful for overriding implementations of the somtSetSymbolsOnEntry method, which 
takes the prefix as an argument. 

Parameters 

prefix 

The prefix of the symbol to be created. 

stem 

The base name of the symbol to be created. 

Return Value 

The somtNewSymbol function returns the new symbol name. Ownership of the string is 
passed to the caller. 

Example 

The following code creates the new symbol name classComment and sets its value: 

SOMTClassEntryC class = get_somtTargetClass (emitter) ; 

SOMTTemplateOutputC template = get_somtTemplate (emitter) ; 

string comment = get_somtEntryComment (class) ; 

_somtSetSymbolCopyValue (template , 

somtNewSymbol ("class" , "Comment" ) , 

(comment ? comment : "")); 



Related Information 

somtSetSymbol Method 
somtSetSymbolCopyBoth Method 
somtSetSymbolCopyName Method 
somtSetSymbolCopyValue Method 
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somtopenEmitFile Function 

Open an output file for an emitter. 



Syntax 

FILE * somtopenEmitFile (char *f Me, char *ext) 

Description 

The somtopenEmitFile function opens the named output file for an emitter. It also sets 
global variables needed by other library functions and adds a header to the newly opened 
file if ext is a known extension. Users can extend the list of known extensions by adding 
them to the value of the SMKNOWNEXTS environment variable, separated by a semicolon. 

Depending on the setting of a global variable, set by the SOM Compiler, the file will be 
opened for either writing or appending. When an emitter is invoked for the first time on a 
particular .idl file, this global variable indicates that the file should be opened for writing. 
When the same emitter is invoked subsequently on the same input file, for example, to 
process interface definitions within a module definition, the global variable indicates that the 
file should be opened for appending. In this way, all output for a single input file goes to the 
same output file, even though the emitter may be invoked multiple times. 

When an interrupt occurs as an emitter is executing, the file opened by somtopenEmitFile 
is removed. If you wish to prevent this during critical portions of the code, call the function 
somtunsetEmitSignals at the beginning of your code segment, and call the function 

somtresetEmitSignals after the segment. 

Parameters 

file 

The name of the file to be opened. If NULL, stdout is returned. 

ext 

The extension of the file to be opened. If the specified filename does not include this 
extension, or if it includes a different extension, a filename is constructed that has the 
specified extension. 

Return Value 

The somtopenEmitFile functions returns a pointer to the opened file or stdout, if no 
filename is specified. 



Example 

FILE *fp = somtopenEmitFile ("hello . foo" , "foo"); 
set_somtTargetFile (emitter , fp) ; 

somtf close (fp) ; 

Related Information 

somtunsetEmitSignals Function 
somtresetEmitSignals Function 
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somtresetEmitSignals Function 

Resumes signal processing after disabling it via the somtunsetEmitSignals function. 



Syntax 



void somtresetEmitSignals ( ); 



Description 

The somtresetEmitSignals function resumes signal processing after disabling it via the 

somtunsetEmitSignals function. 

Example 

somtunsetEmitSignals ( ) ; 

/* do some protected processing */ 

somtresetEmitSignals () ; 

Related Information 

somtunsetEmitSignals Function 
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somtunsetEmitSignals Function 

Prevents signals from being received as an emitter is executing. 



Syntax 

void somtunsetEmitSignals ( ); 

Description 

The somtunsetEmitSignals function prevents signals from being received as an emitter is 
executing. Normally, signals such as internal errors and user-generated interrupts are 
trapped within emitters. It may be necessary to prevent such interrupts from occurring in 
certain sections of an emitter’s code. 

This function is useful for preventing the output file from being removed if an interrupt 
occurs. Normally, when an interrupt occurs, the file opened by somtopenEmitFile is 
removed. To prevent this during critical portions of the code, call somtunsetEmitSignals at 
the beginning of your code segment, and call somtresetEmitSignals after the segment. 

Example 

somtunsetEmitSignals () ; 

/* do some protected processing */ 
somtresetEmitSignals ( ) ; 

Related Information 

somtopenEmitFile Function 
somtresetEmitSignals Function 
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somtwarn Function 

Prints a warning message and increments the warning count maintained by the SOM 
Compiler. 



Syntax 

void somtwarn (string file, long lineno, string format, ...); 

Description 

The somtwarn function prints a warning message and increments the warning count 
maintained by the SOM Compiler. The message begins with the string “warning: ” and 
includes the name of the file and the line number on which the error occurred, if specified. 

Parameters 

file 

The name of the file in which the error occurred, or NULL. 

lineno 

The line number on which the error occurred, or zero. 

format 

A format string suitable for passing to the printf C library function. 

varargs 

The arguments to be passed to printf. 



Example 

somtwarn ( get_somtSourceFileName (els) , 

get_somtSourceLineNumber (entry) , 

"I'm worried about the entry named %s.\n", 
get_somtEntryName (entry) ) ; 



Related Information 

somterror Function 
somtfatal Function 
somtinternal Function 
somtmsg Function 
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somtReadSectionDefinitions method .... 102 

somtresetEmitSignals function 123 

somtScan methods 44 

SOMTSequenceEntryC class 85 

somtSetOutputFile method 103 

somtSetPredefinedSymbols method 46 

somtSetSymbol method 104 

somtSetSymbolCopyBoth method 105 

somtSetSymbolCopyName method 106 

somtSetSymbolCopyValue method 107 

somtSetSymbolsOn Entry method 57 

SOMTStringEntryC class 86 

SOMTStructEntryC class 87 

somtGetFirstMember method 88 

somtGetNextMember method 89 

SOMTTemplateOutputC class 90 

somtAddSectionDefinitions method .... 93 

somtCheckSymbol method 94 

somtExpandSymbol method 95 

somtGetSymbol method 97 

somto method 98 

somtOutputComment method 99 

somtOutputSection method 100 

somtReadSectionDefinitions method .. 102 

somtSetOutputFile method 103 

somtSetSymbol method 104 

somtSetSymbolCopyBoth method .... 105 
somtSetSymbolCopyName method ... 106 
somtSetSymbolCopyValue method ... 107 

SOMTTypedefEntryC class 108 

somtGetFirstDeclarator method 109 

somtGetNextDeclarator method 110 

SOMTUnionEntryC class Ill 

somtGetFirstCaseEntry method 112 
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somtGetNextCaseEntry method 113 

somtunsetEmitSignals function 124 

SOMTUserDefinedTypeEntryC class .... 114 

somtVA method 47 

somtwarn function 125 
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